#下单接口
#请求路径
/api/pos/order/placeOrder#参数列表
| 名称 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| orderId | String | 48 | 是 | 商户唯一订单号 |
| amount | Long | - | 是 | 交易金额,需要放大100倍,例如 0.1N -> 10N |
| sn | String | 32 | 是 | 设备号 |
| bizType | String | 32 | 是 | 交易类型, 枚举: Purchase |
| callbackUrl | String | 255 | 是 | 请求回调地址 |
#返回值
| 名称 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| sn | String | 32 | 是 | 设备号 |
| orderId | String | 48 | 是 | 商户唯一订单号 |
| orderNo | String | 32 | 是 | Palmpay唯一订单号 |
| amount | Long | - | 是 | 交易金额,需要放大100倍,例如 0.1N -> 10N |
| status | Integer | 32 | 是 | 订单状态 WAIT_NOTIFY(1) // 待通知 WAIT_PAY(2) // 待支付 PAYING(3) // 支付中 PAYED(4) // 已支付 CANCEL_PAY(5) // 取消支付 SUCCESS(6) // 业务单成功 FAIL(7) // 业务单失败 PENDING(8) // 业务单Pending |
| bizType | String | 32 | 是 | 交易类型, 枚举: Purchase |
| callbackUrl | String | 255 | 是 | 请求回调地址 |
#错误码
#Postman请求示例
#request
curl --location --request POST 'https://open-gw-sandbox.palmpay-inc.com/api/pos/order/placeOrder' \
--header 'Accept: application/json, text/plain, */*' \
--header 'CountryCode: NG' \
--header 'Authorization: Bearer L240910133611075343802' \
--header 'Signature: HCqTeD2vxJMCEp9vLujBqztR5na+SW9Xx3UuNYOHW7gvCRmvrA2f6EYa+JPzSEpfBqnXfW9omatet2lWXfOI1uLpG0/pE44d5yIHK1YucRRznjHlircsurDgBSxE0BLu5ZbOvLBCcyyHD+SERyVLDV1fOOtgcK5ghbSRsvAs+QBbd9EAgzm3Fse1zEVFBVpkMdJhIqPgzO6rWuFeFQFeOwD5kVoo1YlWs32uWWxXSRKGm38tbovyO5N6eMbAmEdrUPrhiZ1B+vdlngRTdtpPE06z0bUmWy4prlFU4htJD1+RQWta8nejFSYgU+hQKQHxWs1pvTKv+hrsowBEIdOdRA==' \
--header 'Content-Type: application/json' \
--data '{
"orderId": "2025test001",
"amount": 100,
"sn": "PBE5226U30494",
"bizType": "Purchase",
"callbackUrl": "https://ms.palmpay-inc.com/#/api/automation",
"requestTime": 1546857549088,
"version": "V2.0",
"nonceStr": "tXIUBaQUUip97xhymcgvndYo6oSAvQXP"
}'#response
{
"respCode": "00000000",
"respMsg": "success",
"data": {
"sn": "PBE5226U30494",
"orderId": "2025test001",
"orderNo": null,
"amount": 100,
"status": 2,
"bizType": "Purchase",
"callbackUrl": "https://ms.palmpay-inc.com/#/api/automation"
}
}