• 简体中文
  • 下单接口

    请求路径

    /api/pos/order/placeOrder

    参数列表

    名称类型长度必填描述
    orderIdString48是商户唯一订单号
    amountLong-是交易金额,需要放大100倍,例如 0.1N -> 10N
    snString32是设备号
    bizTypeString32是交易类型, 枚举: Purchase
    callbackUrlString255是请求回调地址

    返回值

    名称类型长度必填描述
    snString32是设备号
    orderIdString48是商户唯一订单号
    orderNoString32是Palmpay唯一订单号
    amountLong-是交易金额,需要放大100倍,例如 0.1N -> 10N
    statusInteger32是订单状态 WAIT_NOTIFY(1) // 待通知 WAIT_PAY(2) // 待支付 PAYING(3) // 支付中 PAYED(4) // 已支付 CANCEL_PAY(5) // 取消支付 SUCCESS(6) // 业务单成功 FAIL(7) // 业务单失败 PENDING(8) // 业务单Pending
    bizTypeString32是交易类型, 枚举: Purchase
    callbackUrlString255是请求回调地址

    错误码

    参见此文

    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"
      }
    }