Update application

Staging

https://fin-api.digetpay.com

PATCH

/v1/developer-portal/applications/{id}

Applies partial updates to the application settings (integration model,
URLs, redirect origins, support contact, ...). Empty / undefined fields are
left untouched. Suspended applications reject updates.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/jsonRequired

Example

{
    "name": "Acme Checkout Plus",
    "description": "Payment checkout for Acme services.",
    "integrationModel": "DIRECTORY",
    "websiteUrl": "https://acme.sa",
    "privacyPolicyUrl": "https://acme.sa/privacy",
    "termsUrl": "https://acme.sa/terms",
    "supportContact": {
        "email": "support@acme.sa",
        "phone": "+966501234567"
    },
    "redirectUrls": [
        "https://acme.sa/oauth/callback"
    ],
    "deepLinkUrl": "acme://pay",
    "allowedWebOrigins": [
        "https://webview.acme.sa"
    ],
    "partnerApiBaseUrl": "https://api.acme.sa/v1"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH 'https://fin-api.digetpay.com/v1/developer-portal/applications/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Acme Checkout Plus",
    "description": "Payment checkout for Acme services.",
    "integrationModel": "DIRECTORY",
    "websiteUrl": "https://acme.sa",
    "privacyPolicyUrl": "https://acme.sa/privacy",
    "termsUrl": "https://acme.sa/terms",
    "supportContact": {
        "email": "support@acme.sa",
        "phone": "+966501234567"
    },
    "redirectUrls": [
        "https://acme.sa/oauth/callback"
    ],
    "deepLinkUrl": "acme://pay",
    "allowedWebOrigins": [
        "https://webview.acme.sa"
    ],
    "partnerApiBaseUrl": "https://api.acme.sa/v1"
}'

Responses

🟢200OK

application/json

The updated application.

Bodyapplication/json

Example

{
    "id": "7",
    "name": "Acme Checkout",
    "description": "Payment checkout for Acme services.",
    "integrationModel": "DIRECTORY",
    "status": "DRAFT",
    "logoPath": "https://storage/dgp/logo.png",
    "bannerPath": "https://storage/dgp/banner.png",
    "websiteUrl": "https://acme.sa",
    "privacyPolicyUrl": "https://acme.sa/privacy",
    "termsUrl": "https://acme.sa/terms",
    "supportContact": {
        "email": "support@acme.sa",
        "phone": "+966501234567"
    },
    "redirectUrls": [
        "https://acme.sa/oauth/callback"
    ],
    "deepLinkUrl": "acme://pay",
    "allowedWebOrigins": [
        "https://webview.acme.sa"
    ],
    "partnerApiBaseUrl": "https://api.acme.sa/v1",
    "productionRequestedAt": "2026-08-10T14:20:00.000Z",
    "productionApprovedAt": "2026-08-12T09:00:00.000Z",
    "productionReviewNotes": "Approved after certification PASSED.",
    "reviewNotesJson": {
        "branding": "2026-09-02: Logo updated per reviewer request"
    },
    "submittedAt": "2026-09-02T10:00:00.000Z",
    "createdAt": "2026-07-25T10:00:00.000Z",
    "updatedAt": "2026-08-12T09:00:00.000Z",
    "listing": {
        "id": "9",
        "applicationId": "7",
        "status": "DRAFT",
        "nameEn": "Acme Checkout",
        "nameAr": "تشيك أوت أكمة",
        "descriptionEn": "DigetPay checkout for Acme services.",
        "descriptionAr": "الدفع عبر ديجت باي لخدمات أكمة.",
        "iconPath": "https://storage/dgp/logo.png",
        "bannerPath": "https://storage/dgp/banner.png",
        "screenshots": [
            "https://storage/dgp/screen-1.png"
        ],
        "targetCountries": [
            "SA"
        ],
        "isFeatured": false,
        "publishAt": "2026-08-20T08:00:00.000Z",
        "publishedAt": "2026-08-15T12:00:00.000Z",
        "reviewNotes": {
            "branding": "2026-08-10: Logo updated per reviewer request"
        },
        "categoryId": "3"
    },
    "environments": [
        "SANDBOX"
    ]
}

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

Modified at 2026-09-16 09:43:02

Application detail

Request production activation (certification must be PASSED)