← Back to Account Payouts docs
← Back to Parties docs
| Available | Coming soon |
targetCurrency | Must be null |
countryCode | Beneficiary's country of their residential (if payee is an individual) or registered (if payee is a company) address. Enter the 2 character ISO 3166-1 standard country code in your API request. Please refer to the below list of countries where USDC payouts are prohibited or unsupported. |
| Earliest beneficiary credit | real-time |
| Cut-off time (UTC) | N/A |
| Decimal places | 2 |
Minimum targetAmount | 5 |
Maximum targetAmount | 9999999.99 |
| API field name | Required? | Field length | Description |
|---|---|---|---|
channel | ✅ | N/A | Blockchain network. Available values:
Important You must provide the correct blockchain network. Incorrect or inconsistent information may result in the payout being sent on a different blockchain than intended. As blockchain transactions are generally irreversible, funds sent on an incorrect blockchain may be inaccessible, difficult to recover, or permanently lost. |
expandableKeyValuePairs.tag | ❌ | object or null | Identifier on the blockchain level that some exchanges use to identify users. |
beneficiaryWalletDetails.walletIdentifierType | ✅ | N/A | Must be:
|
beneficiaryWalletDetails.walletIdentifier | ✅ | 1-64 | Beneficiary wallet address on the selected blockchain. Important You must provide the correct wallet address. Incorrect or inconsistent information may result in the payout being transferred to an unintended recipient. As blockchain transactions are generally irreversible, funds sent to an incorrect wallet address may be permanently lost and cannot be recovered. |
parties.partyType | ✅ | N/A | Type of the party. Must be:
|
parties.personalDetails.type | ✅ | N/A | Entity description code for the party. Available values:
|
parties.personalDetails.title | Conditional | N/A | Title code for the individual. Available values:
Condition Mandatory if parties.personalDetails.type is:
|
parties.personalDetails.firstName | Conditional | Max 50 | Beneficiary first name. Full name should be provided (no initials). Condition Mandatory if parties.personalDetails.type is:
|
parties.personalDetails.middleName | ❌ | Max 50 | Beneficiary middle name. |
parties.personalDetails.lastName | Conditional | Max 50 | Beneficiary last name. Full name should be provided (no initials). Condition Mandatory if parties.personalDetails.type is:
|
parties.personalDetails.companyName | Conditional | Max 140 | Full name of the organization. Important Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space. To whitelist any other naming format please contact your Relationship Manager. Condition Mandatory if parties.personalDetails.type is:
|
parties.personalDetails.dateOfBirth | Conditional | 10 | Beneficiary's date of birth in YYYY-MM-DD format. Condition Mandatory if parties.personalDetails.type is:
|
parties.personalDetails.dateOfIncorporation | ❌ | 10 | A company's date of incorporation in YYYY-MM-DD format. |
parties.identityDocuments.type | Conditional | N/A | Beneficiary's identity type. Available values:
Condition Mandatory if parties.personalDetails.type is:
|
parties.identityDocuments.number | Conditional | 1-35 | Beneficiary's Company Registration Number. Condition Mandatory if parties.personalDetails.type is:
|
parties.identityDocuments.issuingCountry | Conditional | 2 | Beneficiary's country code of their identification document. Enter the 2 character ISO 3166-1 standard country code in your API request. Condition Mandatory if parties.personalDetails.type is:
|
parties.personalDetails.email | Strongly recommended | Max 50 | Beneficiary's email address. |
parties.personalDetails.phones.number | Strongly recommended | 5-20 | Phone number of the beneficiary. |
parties.personalDetails.phones.prefix | Strongly recommended | 1-3 | Phone country dialing code of the beneficiary. |
parties.address.address1 | Strongly recommended | Max 35 | Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street. |
parties.address.address2 | ❌ | Max 35 | Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio. |
parties.address.city | Strongly recommended | Max 35 | Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address. |
parties.address.state | ❌ | Max 35 | Beneficiary's state code of residential address (if payee is an individual) or registered address (if payee is a company). |
parties.address.postalCode | ❌ | 5-9 | Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address. |
parties.address.countryCode | Strongly recommended | 2 | Beneficiary's country of their residential (if payee is an individual) or registered (if payee is a company) address. Enter the 2 character ISO 3166-1 standard country code in your API request. Please refer to the below list of countries where USDC payouts are prohibited or unsupported. |
Important
Additional data is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB).
| Country name | Country code |
|---|---|
| Afghanistan | AF |
| Belarus | BY |
| Congo, The Democratic Republic of the | CD |
| Cuba | CU |
| Democratic People's Republic of Korea (DPRK) | KP |
| Haiti | HT |
| Iran | IR |
| Iraq | IQ |
| Lebanon | LB |
| Libya | LY |
| Myanmar | MM |
| Palestine | PS |
| Russian Federation | RU |
| Somalia | SO |
| South Sudan | SS |
| Sudan | SD |
| Syria | SY |
| Ukraine | UA |
| Venezuela | VE |
| Yemen | YE |