Skip to main content

AddVpaScene API

Endpoints

Live POST https://pay.onlinepay.ai/card/addVpaScene

Sandbox POST https://testpay.onlinepay.ai/card/addVpaScene

Request Parameters

Basic Information

ParameterTypeRequiredDescription
merNoIntegerYesMerchant Number, Unique identifier assigned to the merchant by the onlinepay payment platform when registering with onlinepay
sceneNameStringYes
typeStringYes0:time limit 1:cycle limit 2:single limit
cycleTypeStringNorequired when type=1, 0:Natural month 1:Natural day
cycleDayStringNorequired when type=1 and cycleType=1, value range:1-28
maxNumStringNorequired when type=0 or 1
maxAmountStringNo
startTimeStringNorequired when type=0
endTimeStringNorequired when type=0
signstringYesSignature, MD5(merNo+privateKey) or RSA

Example Request

{
"merNo": "104001001",
"sceneName": "test",
"type": "1",
"cycleType": "0",
"maxNum": "10000",
"maxAmount": "100000",
"sign": "e8b6b0b9f0b0f8b0b8b0a0b0c0d0e0f"
}

Responses Body

ParameterTypeRequiredDescription
codestringYesIf the value is 00000, it will return success, other please refer to Error Code
messagestringYesInterface returns description
datastringYessenceId

Example Responses

{
"code":"00000",
"message":"SUCCESS",
"data":"455"
}