Submit a company information change request

Staging

https://fin-api.digetpay.com

POST

/v1/developer-portal/company/change-request

Creates a new change request with the provided field changes. Only allowed
when the developer's verification is APPROVED and no pending request exists.

The submitted changes enter PENDING_REVIEW and do not overwrite the
currently-approved data until an admin approves.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Body Params application/jsonRequired

Example

{
    "name": "Acme Payment Solutions",
    "legalName": "Acme Payment Solutions LLC",
    "contactPhone": "+966501234567",
    "commercialRegNo": "1010-1234567",
    "taxNumber": "312345678901234",
    "businessCategory": "Fintech / Payments",
    "websiteUrl": "https://acme.sa",
    "country": "SA",
    "businessAddress": "King Fahd Rd, Riyadh",
    "bankName": "Al Rajhi Bank",
    "iban": "SA0380000000608010167519",
    "contacts": {
        "technical": {
            "email": "dev@acme.sa"
        },
        "finance": {
            "email": "fin@acme.sa"
        }
    }
}

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/company/change-request' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Acme Payment Solutions",
    "legalName": "Acme Payment Solutions LLC",
    "contactPhone": "+966501234567",
    "commercialRegNo": "1010-1234567",
    "taxNumber": "312345678901234",
    "businessCategory": "Fintech / Payments",
    "websiteUrl": "https://acme.sa",
    "country": "SA",
    "businessAddress": "King Fahd Rd, Riyadh",
    "bankName": "Al Rajhi Bank",
    "iban": "SA0380000000608010167519",
    "contacts": {
        "technical": {
            "email": "dev@acme.sa"
        },
        "finance": {
            "email": "fin@acme.sa"
        }
    }
}'

Responses

🟢200OK

application/json

The created change request.

Bodyapplication/json

Example

{
    "id": "42",
    "status": "PENDING_REVIEW",
    "proposedData": {},
    "documents": [
        {
            "id": "601",
            "kind": "COMMERCIAL_REGISTRATION",
            "fileName": "commercial-registration-new.pdf",
            "fileUrl": "string",
            "createdAt": "2026-09-01T10:00:00.000Z"
        }
    ],
    "reviewNotes": "string",
    "submittedAt": "2026-09-01T10:00:00.000Z",
    "decidedAt": "2019-08-24T14:15:22.123Z",
    "createdAt": "2026-09-01T10:00:00.000Z"
}

🟠400Bad Request

🟠401Unauthorized

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

Remove a member

Withdraw a pending change request