v1

latestOpenAPI 3.1.02026-07-26500375.1 KB

Create Virtual Account

The following endpoint creates a new virtual account

post/transfer-va/create-va

Headers

Content-Typestring required

Indicates the media type of the resource. value: application/json

X-TIMESTAMPstring required

Timestamp in ISO8601 format, Example: 2024-05-14T18:54:57+07:00

Authorizationstring required

Represents Access Token (B2B) of a request; string starts with keyword “Bearer ” followed by Access Token (B2B)

X-SIGNATUREstring required

Signature generated by encrypting HTTP method, relative path, access token, minified request body, and timestamp

X-PARTNER-IDstring required

Unique ID for a partner given by Durianpay upon completing registration. Its value is same as the X-CLIENT-KEY

X-EXTERNAL-IDstring required

Unique messaging reference identifier generated by merchant and should be unique within the same day

CHANNEL-IDstring required

Device identification on which the API services is currently being accessed by the merchant. Possible value: 95521

Request body

virtualAccountNamestring required

Mandatory Display name for the virtual account which will appear in ATM/Banking app.

customerNostring

Account suffix for the virtual account. If not provided, a random suffix will be automatically generated for the virtual account number.

virtualAccountTrxTypestring required

"C" = Closed Amount -> only accepts payments that exactly match the predefined amount
"O" = Open Amount -> accepts payments of any amount

trxIdstring required

Transaction reference from merchant’s system. Must be unique.

expiredDatestring

Expiry time in ISO 8601: YYYY-MM-DDThh:mm:ss+07:00. Required if the VA is reusable.