Make a Fiat Payout
This endpoint allows you to make a payout to a Business or an Individual.
To create a Fiat Payout, you must first acquire the following:
- Recipient's bank account details, including the bank code:
- SCANfor GBP payments
- IBAN and BIC for EUR payments
- ABA Routing Number for USD payments
- Recipient's account number
If invalid bank details are provided, such as an incorrect bank code or account number, the payout request will be rejected with an error message returned.
Metadata-supported endpoint
This endpoint allows you to include custom additional information with your request. The provided metadata will also be returned in the status endpoint for reference.
Make a payout
To make a payout to, send the POST /payment/v1/payouts
request with the corresponding payload:
{
"walletId": "a:24071743000626:go5SB1l:1",
"amount": {
"value": "100.00",
"currency": "GBP"
},
"paymentReference": "Ref112455",
"instruction": {
"type": "FIAT",
"beneficiary": {
"reference": null,
"details": {
"beneficiaryType": "SELF_OWNED",
"transferDestination": "LOCAL",
"currency": "GBP",
"businessDetails": {
"businessName": "Company ABC"
},
"address": {
"addressLine1": "Some address Line 1",
"addressLine2": "Some address Line 2",
"city": "Some city",
"region": "Some region",
"postCode": "ABCDEF",
"country": "GB"
},
"bankDetails": {
"accountNumber": "00015179",
"code": "040825",
"address": {
"country": "GB"
}
}
}
}
},
"requestDetails": {
"originator": {
"ipAddress": "5.57.72.118"
}
},
"metadata": {
"someKey": "someValue",
"someKey2": {
"someKey3": "someValue3"
}
}
}
{
"walletId": "a:24071743003474:xE95Oq7:1",
"amount": {
"value": "100",
"currency": "EUR"
},
"paymentReference": "0IIJSsG4kz",
"instruction": {
"type": "FIAT",
"beneficiary": {
"reference": null,
"details": {
"beneficiaryType": "SELF_OWNED",
"transferDestination": "LOCAL",
"currency": "EUR",
"businessDetails": {
"businessName": "Company ABC"
},
"address": {
"country": "FR"
},
"bankDetails": {
"accountNumber": "FR7630006000011234567890189",
"code": "AGRIFRPP",
"address": {
"country": "FR"
}
}
}
}
},
"requestDetails": {
"originator": {
"ipAddress": "5.57.72.118"
}
},
"metadata": {
"someKey": "someValue",
"someKey2": {
"someKey3": "someValue3"
}
}
}
{
"walletId": "a:24071743000626:go5SB1l:1",
"amount": {
"value": "100.00",
"currency": "USD"
},
"paymentReference": "Ref112455",
"instruction": {
"type": "FIAT",
"beneficiary": {
"reference": null,
"details": {
"beneficiaryType": "SELF_OWNED",
"transferDestination": "LOCAL",
"currency": "USD",
"businessDetails": {
"businessName": "Company ABC"
},
"address": {
"addressLine1": "Some address Line 1",
"addressLine2": "Some address Line 2",
"city": "Some city",
"region": "Some region",
"postCode": "ABCDEF",
"country": "US"
},
"bankDetails": {
"accountNumber": "987654321",
"code": "021000021",
"accountType": "checking",
"address": {
"country": "US"
}
},
"paymentMethod": "ACH"
}
}
},
"requestDetails": {
"originator": {
"ipAddress": "5.57.72.118"
}
},
"metadata": {
"someKey": "someValue",
"someKey2": {
"someKey3": "someValue3"
}
}
}
{
"walletId": "a:24101731223387:BvR3I1g:1",
"amount": {
"value": "5",
"currency": "USD"
},
"paymentReference": "REF123",
"instruction": {
"type": "FIAT",
"beneficiary": {
"details": {
"alias": "Some Alias",
"beneficiaryType": "SELF_OWNED",
"transferDestination": "INTERNATIONAL",
"currency": "USD",
"businessDetails": {
"businessName": "Marc Ltd"
},
"address": {
"addressLine1": "7b Manor Gardens",
"addressLine2": "Apt 5",
"city": "Hout Bay",
"region": "WC",
"postCode": "7806",
"country": "ZA"
},
"bankDetails": {
"accountNumber": "FR1420041010050500013M02606",
"code": "PSSTFRPPLIL",
"bankName": "La Banque Postale",
"address": {
"addressLine1": "3 RUE PAUL DUEZ",
"addressLine2": "Apt 5",
"city": "LILLE CEDEX 9",
"region": "Western Cape",
"postCode": "59900",
"country": "FR"
},
"intermediaryBanks": [
{
"bankName": "some bank",
"code": "PSSTFRPPLIL",
"address": {
"addressLine1": "3 RUE PAUL DUEZ",
"addressLine2": "Apt 5",
"city": "LILLE CEDEX 9",
"region": "Western Cape",
"postCode": "59900",
"country": "FR"
}
}
]
}
}
}
},
"requestDetails": {
"originator": {
"ipAddress": "5.57.72.118"
}
},
"metadata": {
"someKey": "someValue",
"someKey2": {
"someKey3": "someValue3"
}
}
}
In the successful response, you receive transaction details:
{
"transactionReference": "1a0c24c7-c578-40ff-92cc-7a56c320db00",
"fee": {
"value": 0.00,
"currency": "GBP"
}
}
The above example uses GBP
, the response will vary on the currency field for EUR
and USD
payouts.
In response, you will also receive a POST
location
header containing the transactionReference
.
Updated 3 days ago