Create application (requires APPROVED verification)

Staging

https://fin-api.digetpay.com

POST

/v1/developer-portal/applications

Creates an application in status DRAFT.

Requires the developer organization verification to be APPROVED — otherwise
400. The application is created empty; configure it via PATCH.

New applications are always created with integrationModel EMBEDDED (the field
may be omitted from the body).

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Body Params application/jsonRequired

Example

{
    "name": "Acme Checkout",
    "description": "Payment checkout for Acme services.",
    "integrationModel": "DIRECTORY"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://fin-api.digetpay.com/v1/developer-portal/applications' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Acme Checkout",
    "description": "Payment checkout for Acme services.",
    "integrationModel": "DIRECTORY"
}'

Responses

🟢200OK

application/json

The created 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

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

List applications

Active marketplace categories (for the listing form)