Skip to navigation

View the schema for a Recipient

Fetch the data requirements for a given currency, payout method type, and recipient type

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

If your platform is using a proxy to take SCA-triggering action on behalf of users, you also need to integrate mTLS authentication and use the api-mtls base URL.

Path parameters

ClientIdstringRequired
Platform's API account identifier, associated with the API key.

Query parameters

PayoutMethodTypestringRequired

Allowed values: LocalBankTransfer, InternationalBankTransfer

The payout method.

CurrencystringRequired

Allowed values: The three-letter ISO 4217 code of a supported currency: AED, AUD, CAD, CHF, CNH, CZK, DKK, EUR, GBP, HKD, HUF, ILS, JPY, MXN, NOK, NZD, PLN, RON, SAR, SEK, SGD, TRY, USD, ZAR

The currency of the recipient.

CountrystringRequired

Format: Two-letter country code (ISO 3166-1 alpha-2 format)

The destination country of the payout method.

RecipientTypestringRequired

Allowed values: Individual, Business

The recipient type:

  • Individual – An account held by a natural person
  • Business – An account held by a legal entity

Response

Success
DisplayNameobjectOptional

Field metadata returned by GET View the schema for a Recipient.

CurrencyobjectOptional

Field metadata returned by GET View the schema for a Recipient, including allowed values.

CountryobjectOptional

Field metadata returned by GET View the schema for a Recipient, including allowed values.

RecipientTypeobjectOptional

Field metadata returned by GET View the schema for a Recipient, including allowed values.

PayoutMethodTypeobjectOptional

Field metadata returned by GET View the schema for a Recipient, including allowed values.

TagobjectOptional

Field metadata returned by GET View the schema for a Recipient.

RecipientScopeobjectOptional

Field metadata returned by GET View the schema for a Recipient, including allowed values.

IndividualRecipientobjectOptional

The schema of the IndividualRecipient property.

BusinessRecipientobjectOptional

The schema of the BusinessRecipient property.

InternationalBankTransferobjectOptional

The schema of the InternationalBankTransfer property.

LocalBankTransferobjectOptional

The schema of the LocalBankTransfer property.

Errors

400
Bad Request Error