The Payee Object

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

AttributeDescriptionFormat/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 formatSee Metadata for more information.
status
string		Status of the Payee.CREATED or ACTIVE