Update company / verification data (DRAFT or INFO_REQUIRED only)

Staging

https://fin-api.digetpay.com

PATCH

/v1/developer-portal/company

Applies partial updates to company profile and verification fields.

Editable only while verification is DRAFT or INFO_REQUIRED — once submitted
or approved, updates return 400 until an admin sends the request back.

Re-uploading the same document kind replaces the previous row.

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 --request PATCH 'https://fin-api.digetpay.com/v1/developer-portal/company' \
--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 refreshed company profile.

Bodyapplication/json

Example

{
    "organization": {
        "id": "42",
        "name": "Acme Payment Solutions",
        "legalName": "Acme Payment Solutions LLC",
        "email": "dev@company.com",
        "phone": "+966501234567",
        "status": "ONBOARDING",
        "createdAt": "2026-07-20T08:15:00.000Z"
    },
    "verification": {
        "id": "42",
        "status": "DRAFT",
        "commercialRegNo": "1010-1234567",
        "taxNumber": "312345678901234",
        "businessCategory": "Fintech / Payments",
        "websiteUrl": "https://acme.sa",
        "country": "SA",
        "businessAddress": "King Fahd Rd, Riyadh",
        "bankName": "Al Rajhi Bank",
        "ibanMasked": "••••",
        "contacts": {},
        "reviewNotes": "Awaiting updated tax certificate.",
        "submittedAt": "2026-08-01T09:30:00.000Z",
        "decidedAt": "2026-08-02T11:00:00.000Z"
    },
    "documents": [
        {
            "id": "501",
            "kind": "COMMERCIAL_REGISTRATION",
            "fileName": "commercial-registration.pdf",
            "fileUrl": "https://storage.googleapis.com/...",
            "status": "PENDING",
            "reviewNote": "Registration OK. Verify tax certificate matches.",
            "createdAt": "2026-08-01T09:30:00.000Z"
        }
    ]
}

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

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

Respond to a single information request

Onboarding readiness for verification submit and marketplace