Payment Request API
Last updated
Last updated
Params Name
Description
Required
Notes
action
Action name (Constant Value)
Y
"MAPPPAY"
version
Version number
Y
"1.1"
merchant_id
Merchant ID
Y
Provided by OTT Pay
data
Encrypted Transaction Data
Y
See "Data" table below
md5
Message Digest
Y
Request Example(JSON Data):
Params Name
Description
Required
Notes
order_id
Order ID
N
OrderID could be generated by client's code, or generated by OTTPay as default
operator_id
Operator ID
Y
Operator ID provided by OTTPay
amount
Transaction Amount
Y
String, 100 for 1.00 dollar
Tip
Tip
N
String, 100 for 1.00 dollar
biz_type
Message Digest
Y
"WECHATPAY"
app_id
mini-prog ID with WebChat
Y
open_id
User id with WebChat
Y
call_back_url
Call Back URL
Y
OTT Pay send back with payment result to call back URL
Params Name
Description
Required
Notes
rsp_code
Response code
Y
refer to Appendix B
rsp_msg
Response message
Y
data
Transaction Data Encrypted
Y
See "Data" table below
md5
Message Digest
Y
Params Name
Description
Required
Notes
payInfo
data to activate WeChat-Pay
Y
refer to payInfo
merchant_id
order id from Acquirer
Y
Returned by the Payment Service Provider (e.g. WeChat Pay, Alipay)
order_id
Order ID
Y
amount
amount
Y
String, 100 for 1.00 dollar
sale_num
sale_num
Y
Params Name
Description
Required
Notes
appId
appId in WeChat-MiniProg
Y
timeStamp
timeStamp
Y
nonceStr
nonceStr
Y
packageStr
packageStr
Y
signType
signType
Y
"MD5"
paySign
paySign
Y
By using of above payInfo parameters: appid, timestamp, nonceStr, packageStr, signType, paySign, make payment request within Mini-Program as below,
Once API server finished the request process, it will send back process status to specified URL which been set up as field of 'call_back_url' within above API request parameters.
Params Name
Description
Required
Notes
rsp_code
Response code
Y
refer to Appendix B
rsp_msg
Response message
Y
merchant_id
Merchant ID
Y
data
Encrypted Transaction Data
Y
See "Data" table below
md5
Message Digest
Y
Params Name
Description
Required
Notes
finish_time
Payment time
Y
YYYYMMDDHHMMSS (Beijing time)
order_id
Order ID
Y
amount
Transaction amount
Y
bizpay_order_id
order id from Acquirer
Y
Returned by the Payment Service Provider (e.g. WeChat Pay, Alipay)
merchant_id
Merchant ID
Y
Provided by OTT Pay
refer to
refer to
Data Example(JSON Data):
Response Example(JSON Data):
Data with PayInfo Example(JSON Data, after decrypted):
Call-Back Message Example(JSON Data):
Data Example(JSON Data, after decrypted):