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
- Complete onboarding for the account.
- Complete the account’s standard KYC/KYB flow.
- Store the Due account ID, such as
acct_DqvgNSAuQv5OEK9v. - Use the account ID in the
Due-Account-Idheader to check availability: callGET /v1/channelsbefore 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_v1curl --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:
| Value | Description |
|---|---|
<API_KEY> | Your Due API key. |
acct_DqvgNSAuQv5OEK9v | The account ID that needs AED bank virtual accounts. |
aed_bank_v1 | The 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.
| Field | Description |
|---|---|
status | One 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_v1If 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.
Updated 6 days ago