Skip to navigation

Create new VA

View as Markdown

This API creates a new virtual account for a specified customer via a selected Payment Service Provider (PSP). It returns the details of the virtual account including the account number and related metadata.

Request Body:

FieldTypeRequiredDescription
pspIdstringYesIdentifier for the Payment Service Provider (e.g., "finmo").
customerIdstringRequired for Finmo only. It’s optional for othersUnique identifier of the customer for whom the virtual account is created.
currencystringYesISO 4217 currency code for the virtual account (e.g., "SGD").
countrystringYesISO 3166-1 alpha-2 country code (e.g., "SG" for Singapore).

Request

This endpoint expects an object.
pspIdstringRequired
countrystringRequired
currencystringRequired
customerIdstringRequiredformat: "uuid"

Response headers

PragmastringOptional
ExpiresstringOptional
Request-IdstringOptional
Cache-ControlstringOptional
X-Frame-OptionsstringOptional
X-XSS-ProtectionstringOptional
X-Content-Type-OptionsstringOptional

Response

OK
idstring
pspIdstring
countrystring
currencystring
methodIdstring
createdAtdatetime
createdBystring
updatedAtdatetime
updatedBystring
customerIdstring
pspVirtualAccountIdstring