AED bank virtual account endorsement

Request the aed_bank_v1 endorsement and complete the required individual or business information for AED bank virtual accounts.

Request the AED bank virtual account endorsement when an account needs access to AED bank virtual account details.

📘

For all statuses and how to handle them with webhooks, see Onboarding & compliance lifecycle.

Eligibility

  • Individuals residing in the UAE are not eligible for AED virtual accounts, regardless of nationality.
  • UAE nationals residing outside the UAE are eligible and must provide proof of address in their country of residence.
  • Companies registered in the UAE mainland are not eligible.
  • UAE free zone entities (FZE, FZCO, FZ LLC) and financial free zone entities (DIFC, ADGM) remain eligible, subject to partner approval.

Prerequisites

  1. Complete onboarding for the account.
  2. Complete the account’s standard KYC/KYB flow.
  3. Store the Due account ID, such as acct_DqvgNSAuQv5OEK9v.
  4. Use the account ID in the Due-Account-Id header to check availability: call GET /v1/channels before requesting the endorsement. If AED is absent from the account’s available channels, the account is not eligible and the endorsement will not unlock an AED virtual account.
curl --request GET \
  --url 'https://api.sandbox.due.network/v1/channels?onlyAvailable=true' \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Due-Account-Id: acct_DqvgNSAuQv5OEK9v'

Inspect the returned channels for currencyCode: "AED" and virtual-account availability. If no available AED channel permits opening a virtual account, do not request the endorsement. Use the same account ID in the Due-Account-Id header when requesting the endorsement.

How AED bank virtual account endorsements work

Request the aed_bank_v1 endorsement for the account before creating AED bank virtual accounts that require this endorsement.

If the endorsement response creates a KYC/KYB submission, complete the requirements returned in the submission.requirements array. After the endorsement is approved, create the AED virtual account through the regular virtual account creation flow.

Request the endorsement

Store the response. Its informationRequests[] and their submissions are not announced by webhook.

Call the endorsement endpoint with the aed_bank_v1 code.

POST /v1/kyc/endorsements/aed_bank_v1
curl --request POST \
  --url https://api.sandbox.due.network/v1/kyc/endorsements/aed_bank_v1 \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Due-Account-Id: acct_DqvgNSAuQv5OEK9v'

Replace:

ValueDescription
<API_KEY>Your Due API key.
acct_DqvgNSAuQv5OEK9vThe account ID that needs AED bank virtual accounts.
aed_bank_v1The endorsement code for AED bank virtual accounts.

Requirements examples

If the endorsement response creates a KYC/KYB submission, complete the requirements returned in the submission.requirements array. The exact requirements depend on the account type.

Individual requirements example

The endorsement submission requires the individual's name, nationality, and address. Provide either a passport issued by any country or an Emirates ID (ID_CARD issued in AE, front and back). A UAE residence permit is not an accepted alternative.

[
  {
    "kind": "static",
    "info": [
      { "key": "firstName", "type": "string" },
      { "key": "lastName", "type": "string" },
      { "key": "nationality", "type": "iso3166_1_alpha2" },
      { "key": "address", "type": "object" }
    ],
    "documents": [
      {
        "category": "ID",
        "oneOf": [
          { "type": "PASSPORT" },
          {
            "type": "ID_CARD",
            "variants": ["FRONT_SIDE", "BACK_SIDE"],
            "issuingCountries": ["AE"]
          }
        ]
      }
    ]
  },
  {
    "kind": "conditional",
    "if": {
      "kind": "static",
      "info": [
        { "key": "nationality", "type": "iso3166_1_alpha2", "oneOf": ["AE"] }
      ]
    },
    "then": {
      "kind": "static",
      "documents": [
        {
          "category": "PROOF_OF_ADDRESS",
          "oneOf": [
            { "type": "PROOF_OF_ADDRESS" }
          ]
        }
      ]
    }
  }
]

Proof of address

Applicants with AE nationality receive an additional PROOF_OF_ADDRESS document requirement. It must evidence residence in their country of residence, outside the UAE. The requirement appears in submission.requirements when you request the endorsement; check that array and upload the document type it specifies.

Business requirements example

The business submission requires the company name, registration number, registration date, and address. For AE-registered companies, it also includes a trade licence document and the aeBusinessTradeLicenseV1 questionnaire. The example below uses the documented company-document LICENSE type; use the exact document category and type returned in your submission if they differ.

[
  {
    "kind": "static",
    "info": [
      { "key": "companyName", "type": "string" },
      { "key": "registrationNumber", "type": "string" },
      { "key": "registrationDate", "type": "date" },
      { "key": "address", "type": "object" }
    ]
  },
  {
    "kind": "conditional",
    "if": {
      "kind": "static",
      "info": [
        {
          "key": "address",
          "type": "object",
          "fields": [
            { "key": "country", "type": "iso3166_1_alpha2", "oneOf": ["AE"] }
          ]
        }
      ]
    },
    "then": {
      "kind": "static",
      "documents": [
        {
          "category": "COMPANY_DETAILS",
          "oneOf": [
            { "type": "LICENSE" }
          ]
        }
      ],
      "questionnaires": [
        { "templateId": "aeBusinessTradeLicenseV1", "questions": [] }
      ]
    }
  }
]

Trade licence questionnaire

For AE-registered companies, answer both questions in aeBusinessTradeLicenseV1: the registering authority (mainland or free zone) and the trade licence expiry date. Use the question IDs and allowed response values returned in submission.requirements; the empty questions array above does not prescribe IDs or response values. Mainland responses are not eligible for AED virtual accounts. Free zone responses proceed to partner review; approval is not guaranteed.

Wait for approval

Wait for endorsement.status_changed with status: approved. Additional information arrives as information requests.

FieldDescription
statusOne of requested, processing, awaiting_approval, approved, processing_error.

After requesting the endorsement, listen for the endorsement.status_changed webhook event and confirm the aed_bank_v1 endorsement is approved before creating AED virtual accounts that require this endorsement.

The event data includes the endorsement owner, code, and status:

{
  "endorsement": {
    "ownerId": "acct_DorIPWFDPGpx0evs",
    "code": "aed_bank_v1",
    "status": "processing"
  }
}

Use endorsement.code to identify the AED endorsement and endorsement.status to track whether it is still processing or approved.

When you receive the webhook, you can also retrieve the endorsement status for the account:

GET /v1/kyc/endorsements/aed_bank_v1

If the endorsement creates a submission, complete the submission first. The endorsement can only be approved after the required information and documents have been provided and reviewed.

Create the AED virtual account

After the endorsement is approved, create the AED virtual account through the regular virtual account creation flow.

Use the account ID in the Due-Account-Id header when creating the virtual account. Creation fails for ineligible accounts even if the endorsement is approved. Confirm eligibility through GET /v1/channels first; an approved endorsement does not make an unavailable AED channel available.


Did this page help you?