BCbcb
Virtual Accounts

Make a Third Party Payment

Changed on

Sends a payment from the virtual account identified by its unique id (UUID) to a one time third party beneficiary.

post/v1/accounts/{accountId}/virtual/{virtualAccountId}/third-party-payment

Request

Path parameters

accountIdnumber required
Example:123

The account id for the segregated account

virtualAccountIdstring required
Example:71c33ef0-4af9-4814-b81e-d5f4dfa96dec

The unique identifier of the virtual account (UUID)

Request body

currencystring required

The 3-letter currency code for the payment. GBP is not supported. Must match the currency of the segregated account the payment is made from.

amountstring required

The amount of the payment, must be greater than 0

referencestring required

The reference for the payment

noncestring required

A unique nonce to guard against duplicate payments

reason'BKFE' | 'BKIP' | 'BKPP' | 'CBLK' | 'INTC' | 'INTP' | 'DEEPT' | 'ACCTCASH' | 'COLL' | 'CSDB' | 'LIMA' | 'NETT' | 'EXTD' | 'OTCD' | 'REPO' | 'SBSC' | 'SLEB' | 'ARGT' | 'AREN' | 'BEXP' | 'BOCE' | 'COMC' | 'LICF' | 'CPYR' | 'SERV' | 'SUPP' | 'TRAD' | 'SUBS' | 'GDSV' | 'GSCB' | 'ROYA' | 'COMT' | 'CHAR' | 'ECPR' | 'EPAY' | 'COMP' | 'DBTC' | 'CLPR' | 'INTE' | 'LOAN' | 'LOAR' | 'RELG' | 'TRFD' | 'PENO' | 'INPC' | 'INPR' | 'INSC' | 'INSU' | 'LBRI' | 'LIFI' | 'PPTI' | 'HLRP' | 'HLST' | 'PLDS' | 'PDEP' | 'PCOM' | 'PLRF' | 'FORW' | 'FXNT' | 'IVPT' | 'REBT' | 'REFU' | 'CDBL' | 'CPKC' | 'EDUC' | 'FEES' | 'GAMB' | 'LOTT' | 'GIFT' | 'INSM' | 'REOD' | 'FAND' | 'GOVT' | 'TCSC' | 'BDLM' | 'RENT' | 'BNET' | 'CORT' | 'CMDT' | 'DERI' | 'DIVD' | 'FREX' | 'HEDG' | 'INVS' | 'SAVG' | 'SECU' | 'TREA' | 'FNET' | 'FUTR' | 'HLTI' | 'DNTS' | 'LTCF' | 'MDCS' | 'VIEW' | 'SWFP' | 'SWPP' | 'SWRS' | 'SWUF' | 'BECH' | 'BENE' | 'SSBE' | 'PEFC' | 'PENS' | 'ADCS' | 'ALMY' | 'BONU' | 'COMM' | 'HREC' | 'SALA' | 'LREB' | 'LREV' | 'RSTX' | 'HSTX' | 'INTX' | 'PTXP' | 'RDTX' | 'TAXS' | 'VATX' | 'WHLD' | 'TAXR' | 'CBTV' | 'ELEC' | 'GASB' | 'PHON' | 'UTLB' | 'WTER' required

The reason for the payment. Must be a predefined purpose code.

preferredScheme'AUTO' | 'SEPA' | 'SEPA_INSTANT' | 'TARGET2' | 'SWIFT'

The preferred payment scheme. Allowed values: AUTO, SEPA, SEPA_INSTANT, TARGET2, SWIFT. Defaults to AUTO when omitted.

Example request

{
  "currency": "EUR",
  "amount": "1.12",
  "reference": "payment-ref",
  "nonce": "1234567890123456",
  "reason": "INTC",
  "preferredScheme": "SEPA_INSTANT",
  "beneficiary": {
    "type": "IBAN_BIC",
    "name": "John Doe",
    "iban": "DE53202208000099106929",
    "bic": "MHSBDEHBXXX",
    "country": "DE",
    "addressLine1": "Friedrichstrasse 100",
    "city": "Berlin",
    "postcode": "10115"
  }
}

Response

The payment was successfully created

transactionIdstring required
end2EndIdstring required

Changes