Sign in

v1

latestOpenAPI 3.1.02026-07-26500375.1 KB

Update Virtual Account API

Use this endpoint to update the properties of an existing virtual account. Common use cases include:

  • Updating the transaction amount for closed virtual accounts

  • Extending or modifying the expiry date of an active virtual account

  • Expiring a virtual account immediately by setting the expiredDate to the current timestamp

This operation requires a valid virtualAccountNo, along with the associated trxId.

put/transfer-va/update-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

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: 95221

Request body

partnerServiceIdstring required

Virtual Account prefix. Please pass the same one as returned in the Create VA API.

customerNostring required

Virtual Account suffix. Please pass the same one as returned in the Create VA API.

virtualAccountNostring required

Full Virtual Account Number. Please pass the same one as returned in the Create VA API.

virtualAccountNamestring required

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

trxIdstring required

Transaction reference from merchant’s system.

expiredDatestring

Expiry time in ISO 8601: YYYY-MM-DDThh:mm:ss+07:00.

Response

This response indicates that update virtual account was successful.

responseCodestring required

Response code indicating the result of the operation.

responseMessagestring required

Message explaining the responseCode.