Payees are external bank accounts to which payments can made from Fiat Accounts. Different types of payments can be made to the same Payee depending on the bank details provided for the Payee at the time of creation.
Payee Object
Attribute | Description | Format/Enum |
---|---|---|
id string | Unique identifier of the Payee. | e.g. pye_ejl2vpn1md315rxko6 |
owner.type string | Owner of the Payee. | MEMBER , END_USER |
owner.id string | Unique identifier of the owner of the Payee. | e.g. eus_j82rl497g47g5ykvzn , mbr_emv4j231821oaz56yx |
type string | Type of Payee. | PERSON or BUSINESS |
name string | Full name of the Payee. | |
currency string | Currency in which the Payee's bank account is held. | Three-letter ISO 4217 code e.g. GBP , EUR , USD |
address.line1 string | First line of Payee's home address. | |
address.line2 string | Second line of the Payee's home address. | |
address.city string | City | |
address.state string | Region or state | |
address.postalCode string | Postal/Zip code | |
address.country string | Payee's address country. | Two-letter ISO 3166-1 alpha-2 country code e.g. GB |
paymentSchemes array of strings | Payment schemes that can be used to make a Payment to the Payee. | FPS , CHAPS , SCT |
bankDetails.iban string | IBAN of the Payee's bank account. Depending on the currency and country, account will typically have at least an IBAN or an accountNumber . | |
bankDetails.bic string | BIC of the Payee's bank account. | |
bankDetails.accountNumber string | Account Number of the Payee's bank account. Depending on the currency and country, account will typically have at least an IBAN or an accountNumber . | |
bankDetails.routingCodes object | One or more routing codes associated with the Payee's bank account. Typically used in conjunction with the account number. | |
bankDetails.routingCodes.type string | Type of the routing code. | SORT_CODE |
bankDetails.routingCodes.value string | Value of the routing code. | |
additionalDetails object | Object containing additional details on the Payee which will depend on bank and payment scheme requirements. | |
additionalDetails.dob date | Date of birth of the Payee. | YYYY-MM-DD format e.g. 1975-04-05 |
createdAt integer | Epoch timestamp at which the object was created. | e.g. 1637593856104 |
updatedAt integer | Epoch timestamp at which the object was last updated. | e.g. 1637593856104 |
metadata array of strings | Additional data in JSON key:value format | See Metadata for more information. |
status string | Status of the Payee. | CREATED or ACTIVE |