v3
latestOpenAPI 3.0.3UNLICENSED2026-07-2796235396.3 KBCustomer beneficiary
This Operation allows user to save beneficiary
Request body
Beneficiary account number, for international payments like SEPA, this is the IBAN, and for Mobile Money, this is the phone number.
Beneficiary account name
Discriminator value for beneficiary type. Possible values are:
- CreateLocalBankAccountBeneficiary: Local bank transfer beneficiary, maps to BeneficiaryLocalBankAccount
- CreateSepaBankAccountBeneficiary: SEPA instant and standard transfer beneficiary. Use this for beneficiaries that will receive SEPA payments. Maps to BeneficiarySepaBankAccount
- CreateACHBankAccountBeneficiary: ACH, FedWire and FedNow transfer beneficiary. Maps to BeneficiaryACHBankAccount
- CreateSwiftBankAccountBeneficiary: SWIFT transfer beneficiary. Maps to BeneficiarySwiftBankAccount
- CreateMobileWalletAccountBeneficiary: Use this for beneficiaries that will receive mobile wallet payments. Maps to BeneficiaryMobileWalletAccount.
Flag to indicate if the beneficiary is a third party
To get the payment channels available, call the /currencies endpoint. The payment channel ID to be used for transfer to this beneficiary. The payment channel ID and the beneficiaryType are mutually exclusive. For example BANK_TRANSFER_NIGERIA uses CreateLocalBankAccountBeneficiary
Response
Beneficiary details saved successfully
Beneficiary identifier
Beneficiary account number, for international payments like SEPA, this is the IBAN
Beneficiary account name
Discriminator value for beneficiary type. Allowed values include:
- BeneficiaryLocalBankAccount
- BeneficiarySepaBankAccount
- BeneficiaryACHBankAccount
- BeneficiarySwiftBankAccount
- BeneficiaryMobileWalletAccount
Flag to indicate if the beneficiary is a third party