Make a Fiat Payout
This endpoint allows you to make a payout to a Business or an Individual.
This feature is discontinued and will be deprecated soon.We're no longer adding updates or improvements to it.
Switch to Initiate Payouts (ver. 2) for the latest functionality.
To create a Fiat Payout, you must first acquire the following:
- Recipient's bank account details, including the bank code:
- SCAN for 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 endpointThis endpoint allows you to include custom additional information with your request. The provided metadata will also be returned in the status endpoint for reference.
To make a payout, 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",
"paymentMethod": "FASTER_PAYMENT",
"beneficiary": {
"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",
"paymentMethod": "SEPA_CT",
"beneficiary": {
"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",
"paymentMethod": "ACH",
"beneficiary": {
"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"
}
}
}
}
},
"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",
"paymentMethod": "SWIFT",
"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"
}
}
}Note the following details:
-
walletId: The value expects the wallet'slsidwhen using the GET Wallets endpoint. -
paymentReference: Reference for the payment. ForACHandACH_SAME_DAYpayouts, this field has a maximum length of 10 characters. -
paymentMethod:ACH: Automated Clearing House (ACH) for USD.ACH_SAME_DAY: ACH Same Day for USD. If you request an ACH Same Day payout outside its available window, it will be process as a next-day payout. However, the ACH Same Day fee may still be incurred.FASTER_PAYMENT: Faster Payments for GBP.SEPA_CT: SEPA Credit Transfer for EUR. Standard SEPA bank transfer. Payment processing time is 1-2 business days.SEPA_INST: SEPA Instant Credit Transfer for EUR. Instant bank transfer. Funds arrive in seconds, 24/7. May incur a small fee.SWIFT: SWIFT for international payments.FEDWIRE: Fedwire for USD.
-
metadata: Custom key-value info for the payment. Returned in thestatusfield of the `GET /payment/v1/payouts/transactionReference request. Max 500 characters.
In the successful response, you receive transaction details:
{
"transactionReference": "1a0c24c7-c578-40ff-92cc-7a56c320db00",
"fee": {
"value": 1000.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 10 days ago