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 .


What’s Next

After making a payout, check its status.