Skip to main content

Create Static VA

Customers use bank virtual accounts to pay merchants

Request#

POST

/gateway/staticva/create

Parameter#

application/json

FieldTypeDescription
merchantCodestring [5..50] charactersUnique merchant code
methodstringPayment method, details are below StaticVa Payment Method list
orderNumstringThis number should be unique for merchant. Dupliated numbers won't be accepted by platform.
productDetailstring <=32 charactersdescription of the bill
namestring <=32 charactersThis name will be displayed on bill page when user pay to the VA
notifyUrlstring <url>When user pay to va, merchant will be notified on this url
dateTimestring <date-time>format yyyyMMddHHmmss
signstring <=512 charactersEncrypted parameters.

Request Example#

{
"merchantCode": "S2020198627344",
"method": "VA_BNC_STATIC",
"orderNum": "T202007183457183",
"productDetail": "iPhone11",
"name": "Asmana",
"notifyUrl": "https://www.merchant-server/callback/pay",
"dateTime": "2019-08-24T14:15:22Z",
"sign": "MIGfMA0GCSqGSI...w1ypbiy7VhIoFJbgSYSSHdC"
}

Response#

Success#

200 application/json

FieldTypeDescription
platRespCodestringresult code: "SUCCESS" "FAIL" "UNKNOWN" "NOTEXIST" "ERROR"
platRespMessagestringdescription of resp code
platOrderNumstringunique order number in platform wide.
orderNumstringunique order number in merchant wide. Same as orderNum in request body.
methodstringtype of bank va
namestring <= 32 charactersThis name will be displayed on bill page when user pay to the VA
vaNumberstringVA account
productDetailstring <= 32 charactersdescription of the bill. same as field in request body.
platSignstringEncrypted response data

Response Example#

{
"platRespCode": "SUCCESS",
"platRespMessage": "success",
"platOrderNum": "VA_BNC_STATIC_1234567890",
"orderNum": "T202007183457183",
"method": "VA_BNC_STATIC",
"name": "Asmana",
"vaNumber": "7416023828374475",
"productDetail": "iPhone11",
"platSign": "MIGfMA0GCSqGSI...w1ypbiy7VhIoFJbgSYSSHdC"
}

StaticVa Payment Method#

CodeDescription
VA_BNC_STATICBNC Bank Repayment Code