Skip to main content

创建 VA 帐户

客户使用银行虚拟账户向商家付款

Request#

POST

/gateway/pay

Parameter#

application/json

FieldTypeDescription
merchantCodestring [5..50] charactersUnique merchant code
methodstringtype of bank va Payment Method
orderNumstringThis number should be unique for merchant. Dupliated numbers won't be accepted by platform.
payMoneynumber <int64>amount to pay. Only integers are accepted.
productDetailstring <=32 charactersdescription of the bill
namestring <=32 charactersThis name will be displayed on bill page when user pay to the VA
emailstring <email>customer email
phonestringuser phone number
notifyUrlstring <url>When user pay to va, merchant will be notified on this url
expiryPeriodstring [30..7200] charactersorder/bill expiration time in minutes
dateTimestring <date-time>format yyyyMMddHHmmss
appIdstring NullableApplication ID. Merchants can create their own applications according to the business. This field is optional.
signstring <=512 charactersEncrypted parameters.

Request Example#

{
"merchantCode": "S2020198627344",
"method": "BCA",
"orderNum": "T202007183457183",
"payMoney": 10000,
"productDetail": "iPhone11",
"name": "Asmana",
"email": "[email protected]",
"phone": "6282300138000",
"notifyUrl": "https://www.merchant-server/callback/pay",
"expiryPeriod": "30",
"dateTime": "20190824141522",
"appId": "4023123456",
"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
emailstring <email>customer email
vaNumberstringVA account
payMoneynumber <int64>same as field in request body.
payFeenumber <int64>fee charged by platform
productDetailstring <= 32 charactersdescription of the bill. same as field in request body.
sourcePartnerNamestringPayee name, will return when the request parameter method value is FT
platSignstringEncrypted response data

Response Example#

{
"platRespCode": "SUCCESS",
"platRespMessage": "success",
"platOrderNum": "BCA_1234567890",
"orderNum": "T202007183457183",
"method": "BCA",
"name": "Asmana",
"email": "[email protected]",
"vaNumber": "7416023828374475",
"payMoney": 10000,
"payFee": 3000,
"productDetail": "iPhone11",
"sourcePartnerName": "Asraf",
"platSign": "MIGfMA0GCSqGSI...w1ypbiy7VhIoFJbgSYSSHdC"
}