Payee
Payees are external bank accounts to which payments can made from Fiat Accounts and Virtual 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.
On creation, Payee's address object is required regardless of currency.
Creating Payee without providing this information will result in getting 400 Bad Request
response.
Payee address can be updated (excluding the country). The format of the request does not change.
Additional details required only for USD Payees:
To create a USD Payee, the following additional details must be provided as part of the Payee's object:
- address: State field (however for non US addresses it can be province, voivodeship, region)
- bank details:
- IBAN + BIC (optional bank country) - for IBAN countries
- Account Number + BIC + Bank Country - for non-IBAN countries
The bankDetails
required for a Payee depend on the currency and the type of payment you want to make to the Payee.
Currency | Required Fields | Supported Payment Schemes |
---|---|---|
GBP | bankDetails.accountNumber bankDetails.routingCodeType (SORT_CODE)bankDetails.routingCodeValue | UK Faster Payments - FPS CHAPS - CHAPS |
EUR | bankDetails.iban bankDetails.bic | SEPA Credit Transfer - SCT |
AUD | bankDetails.accountNumber bankDetails.routingCodeType (BSB)bankDetails.routingCodeValue | Direct Entry - DE |
USD | bankDetails.iban bankDetails.bic or bankDetails.accountNumber bankDetails.bic bankDetails.bankAddressCountry | SWIFT - SWIFT |
When a Payee is created, the response contains a paymentSchemes
param which tells you the Payment Schemes via which the created Payee can be sent a payment.
"paymentSchemes":[
"FPS",
"CHAPS"
]
"paymentSchemes":[
"SCT"
]
"paymentSchemes":[
"DE"
]
"paymentSchemes":[
"SWIFT"
]
ℹ️️ Review Process |
---|
To maintain the highest standards of compliance and effectively restrict third-party payments, a Compliance Review is automatically initiated when there is a discrepancy between the Payee's name and the End User's name, ensuring all Payment processes are transparent and secure.
We work on Compliance Review during business hours.
Payee Statuses
Payee Status | Description |
---|---|
CREATED | Payee has been created on Fiat Republic. |
AWAITING_APPROVAL | Payee is going through 4 eyes check review |
PROCESSING | Payee creation is ongoing. |
ACTIVE | Payee is active and is ready to use |
REJECTED | Payee was not in line with Fiat Republic Acceptable Use Policy or creation was rejected by the Member as part of 4 eyes check |
DELETED | Payee is unavailable |
Updated 10 days ago