Virtual Accounts

Make a Payment

Sends a payment from the virtual account with the given IBAN

post/v1/accounts/{accountId}/virtual/{iban}/payment

Request

Base URL
https://api.bcb.group
Auth
HTTP bearer
TypeScript
https://skmtc.dev/bcb/apis/payments-api/docs/v1/accounts/:accountId/virtual/:iban/payment/post.ts
A function with typed inputs. Its response is checked against the schema.

accountIdnumber required

Example:123

The account id for the segregated account

ibanstring required

Example:GB33BUKB20201555555555

The IBAN of the virtual account

currencystring required

The currency code for the payment

amountstring required

The amount of the payment

referencestring required

The reference for the payment

noncestring required

A unique nonce to guard against duplicate payments

reasonstring required

The reason for the payment

{
  "currency": "GBP",
  "amount": "1.12",
  "reference": "payment-ref",
  "nonce": "1234567890123456",
  "reason": "Internal transfer"
}

The payment was successfully created

transactionIdstring required

end2EndIdstring required