Payment Request API
Support for Alipay, WeChat Pay, UnionPay
✅ Passive Payment Order-创建线下支付订单
👉 商家扫码用户付款二维码(Merchant use scanner to Scan the customers’ QR code)
线下支付订单接口用于带有扫码设备的收银终端进行对接,商户输入金额后要求客户出示支付码,用扫码枪扫码后将扫码内容和金额一并提交并完成支付操作。 线下支付订单接口现已兼容微信、支付宝通道
Passive Payment is used for cashier terminals which can scan BarCode or QRCode. Shop staff input the payment amount and ask customers for their payment code, then system send price and payment code to server and finish the payment. Retail Passive Payment now support Alipay and WeChat Pay, and UnionPay
☑️ Request Message Parameters(JSON Format)
Params Name | Description | Required | Notes |
action | Response code | Y | PASSIVEPAY |
version | Response message | Y | 1.0 |
merchant_id | Merchant ID | Y | |
terminal_no | terminal_no | N | |
operator_id | operator_id | N | |
data | Encrypted Transaction Data | Y | See "Data" table below |
md5 | Message Digest | Y |
✅ Data(JSON Data, to be encrypted):
Params Name | Description | Required | Notes |
order_id | Order ID | N | Optional |
operator_id | Operator ID | Y | Operator ID provided by OTTPay |
amount | Transaction amount | Y | string, "100" for 1.00 dollar. |
tip | tip | N | |
sale_num | sale_num | N | |
auth_code | Auth code | Y | User Bar/QR code from their Apps. (用户出示的钱包条码) |
biz_type | Business type | Y | ALIPAY, WECHATPAY, UNIONPAY |
☑️ Response Message Parameter
Params Name | Description | Required | Notes |
rsp_code | Response code | Y | Please refer to demo.zip |
rsp_msg | Response message | Y | |
data | Encrypted Transaction Data | Y | See "Transaction Data" table below |
md5 | Message digest | Y |
✅ Transaction Data(JSON format, After decrypted)
Params Name | Description | Required | Notes |
order_status | Order status | Y | |
trade_time | Transaction time | N | |
order_id | Order ID | Y | |
buyer_login_id | Buyer ID | Y | |
total_amount | Order total amount | Y | String, "100" for 1.00 dollar |
receive_amount | receive_amount | Y | String, "100" for 1.00 dollar |
pay_amount | User pay amount | Y | String, "100" for 1.00 dollar |
✅ Active Payment Order-创建线下 QRCode 支付单
👉 用户扫商家的收款二维码-Customer Scan the QR code
线下 QRCode 支付用于对接无扫码设备的收银终端,下单后得到二维码地址,自行生成二维码图片后展示在收银终端屏幕上,并由用户使用对应支付客户端进行扫码支付。 线下QRCode 现已同时兼容支付宝、微信客户端进行支付
Retail Active Payment is used for cashier terminals which cannot scan Barcode or QRCode. Get the Code url after create the order, convert this url to a QRCode and ask customers use their app to scan this QRCode then finish the payment. Retail Active Payment now support Alipay, WeChat
☑️ Request Message Parameters(JSON Format)
Params Name | Description | Required | Notes |
action | Action name | Y | ACTIVEPAY |
version | Version number | Y | 1.0 |
merchant_id | Merchant ID | Y | |
terminal_no | terminal_no | N | |
operator_id | Operator ID | N | Operator ID provided by OTTPay |
data | Encrypted Transaction Data | Y | See "Data" table below |
md5 | Message Digest | Y |
✅ Data(JSON Data, to be encrypted):
Params Name | Description | Required | Notes |
order_id | Order ID | N | This ID could be generated by customized rules in client’s code, if not passed, it also could be generated in the background system by default.(您可以自定义订单id 规则,如果不传该参数, 订单id 将按系统规则自动生成) |
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 | ALIPAY, WECHATPAY, UNIONPAY |
call_back_url | Call back URL | Y |
☑️ Response Message Parameter
Params Name | Description | Required | Notes |
rsp_code | Response code | Y | |
rsp_msg | Response message | Y | |
data | Encrypted Data | Y | See "Data" table below |
md5 | Message Digest | Y |
✅ Transaction Data(JSON format, After decrypted)
Params Name | Description | Required | Notes |
code_url | QR code URL | Y | For generating payment QR Code |
order_id | Order ID | Y |
☑️ Call-Back Message Data
Params Name | Description | Required | Notes |
rsp_code | Response code | Y | |
rsp_msg | Response message | Y | |
merchant_id | Merchant ID | Y | |
data | Encrypted Transaction Data | Y | See "Data" table below |
md5 | Message Digest | Y |
▶️ Call-Back Message Example(JSON Data):
✅ Transaction Data (JSON format, after decrypted)
Params Name | Description | Required | Notes |
finish_time | Payment time | Y | YYYYMMDDHHMMSS (Beijing time) |
order_id | Order ID | Y | |
amount | Transaction amount | Y | String, "100" for 1.00 dollar. |
tip | tip amount | N | String, "100" for 1.00 dollar. |
bizpay_order_id | order id from Acquirer | Y | Returned by the Payment Service Provider (e.g. WeChat Pay, Alipay, UnionPay) |
merchant_id | Merchant ID | Y | Provided by OTT Pay |
▶️ Data Example(JSON Data, after decrypted):
Last updated