RetailPayVersion 1.0.2
Create Retail Passive Payment Order
https://pay.globepay.co/api/v1.0/micropay/partners/{partner_code}/orders/{order_id}Retail 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 both Alipay and WeChat
Path Variable
| Field | Type | Description |
|---|---|---|
partner_code | String | Required, Partner code |
order_id | String | Required, Partner order id |
JSON keys
| Field | Type | Description |
|---|---|---|
description | String | Required, Order description |
price | int | Required, Price of the order. Use the base unit of the currency. |
currency | String | currency |
device_id | String | Required, ID of the device which sends the request |
auth_code | String | Required, The Payment QR Code scanned from customer's WeChat Wallet. |
notify_url | String | System will call the notify url if provided when the payment succeeds. |
Query Params
| Field | Type | Description |
|---|---|---|
time | Long | Required, UTC timestamp in milliseconds |
nonce_str | String | Required, Random string |
sign | String | Required, Sign |
Success 200
| Field | Type | Description |
|---|---|---|
return_code | String | Execution result |
result_code | String | Order status
|
order_id | String | Order id in GlobePay, which is also WeChat order id. |
partner_order_id | String | Partner order id |
total_fee | int | Order amount, which uses the base unit of current currency |
real_fee | int | Actual paid amount.(The same as total fee at the moment. After coupon feature is finished, this may be different.) |
pay_time | String | Time when order is paid(yyyy-MM-dd HH:mm:ss, UTC+10) |
create_time | String | Time when order is created(according to the latest order)(yyyy-MM-dd HH:mm:ss, UTC+10) |
currency | String | Currency. Default value is GBP. |
channel | String | Currency. Channel. Alipay,Wechat. |
Error Code
| Name | Description |
|---|---|
ORDER_MISMATCH | Order ID does not belongs to current partner. |
ORDER_PAID | Order has already been paid |
AUTHCODEEXPIRE | QR Code expired |
NOTENOUGH | The customer does not have enough balance to finish the payment |
NOTSUPORTCARD | Card type is not supported |
AUTH_CODE_ERROR | Payment QR Code has been used twice |
AUTH_CODE_INVALID | The submitted QR Code is not a WeChat Payment QR Code |
SYSTEMERROR | Exception inside system |
INVALID_SHORT_ID | Partner code is invalid or there is no partner associated with this code |
SIGN_TIMEOUT | Sign expired, the difference between time and the server time is more than 5 minutes |
INVALID_SIGN | Invalid sign |
PARAM_INVALID | Parameters are invalid. See return_msg for more details. |
NOT_PERMITTED | Gateway payment permission has not been enabled for this partner |
INVALID_CHANNEL | Channel name is not available, check the Capitalize |
ERROR
| Name | Description |
|---|---|
return_code | Error Code |
return_msg | Error Description |