#创建订单
适用市场:NG 尼日利亚 | ZA 南非
#请求路径
/api/v2/payment/merchant/createorderNG 和 ZA 共用,参数按通用 → NG 专属 → ZA 专属排列,通过 NG / ZA 列标示各市场必填情况。
#请求参数
| 参数 | 类型 | 长度 | NG | ZA | 说明 |
|---|---|---|---|---|---|
| orderId | string | 32 | 是 | 是 | 商户唯一订单号(幂等控制) |
| amount | long | — | 是 | 是 | 交易金额(最小单位:分) NG 最低 100 NGN |
| currency | string | 10 | 是 | 是 | 货币 |
| notifyUrl | string | 200 | 是 | 是 | 异步通知接收地址 |
| callBackUrl | string | 200 | 是 | 否 | 支付完成后浏览器跳转地址 |
| nonceStr | string | — | 是 | 是 | 随机字符串(参与签名) |
| requestTime | integer | — | 是 | 是 | Unix 毫秒时间戳 |
| version | string | — | 是 | 是 | NG:V1.1 · ZA:2.0.0.0 |
| productType | string | 100 | 是 | 是 | 固定 bank_card |
| title | string | 100 | 否 | 否 | 订单标题 |
| description | string | 200 | 否 | 否 | 订单描述 |
| orderExpireTime | integer | — | 否 | 否 | 过期时间(秒),默认 1800,范围 1800~86400; 未接入PP收银台的可不传 |
| goodsDetails | string (JSON) | — | 否 | 否 | 商品详情 JSONArray |
| customerInfo | string (JSON) | — | 是 | 否 | 客户信息 JSONObject |
| remark | string | 200 | 否 | 否 | 备注 |
| accessMode | string | — | — | 否 | 默认 redirect direct 直接支付 · redirect 收银台跳转 |
| captureMode | string | — | — | 否 | 支付模式。默认值:immediate。immediate — 即时支付。授权成功后立即扣款。manual — 预授权。资金被预留但不会立即扣除。必须调用 Capture API 完成请款。授权有效期:7 天。过期后授权自动撤销。请款金额:必须 ≤ 授权金额。未指定时默认全额请款。 |
| cardPayerInfo | string (JSON) | — | — | 是 | 卡信息或 Token,见 cardPayerInfo |
是 必填 · 否 选填 · — 该市场不适用
#返回值
| 字段 | 类型 | NG | ZA | 说明 |
|---|---|---|---|---|
| orderNo | string | 是 | 是 | PalmPay 平台订单号 |
| orderStatus | integer | 是 | 是 | 订单状态(见订单状态) |
| currency | string | 是 | 是 | 货币代码 |
| orderAmount | long | 是 | 是 | 交易金额(分) |
| message | string | 否 | 否 | 状态描述 |
| checkoutUrl | string | 否 | 否 | H5 收银台 URL(accessMode=redirect 时返回) |
| payToken | string | 否 | 否 | SDK 支付参数(accessMode=redirect 时返回) |
| sdkSessionId | string | 否 | 否 | SDK 安全密钥(accessMode=redirect 时返回) |
| sdkSignKey | string | 否 | 否 | SDK 安全密钥(accessMode=redirect 时返回) |
| cardToken | string | — | 否 | 卡 Token(rememberCard=true 时返回) |
| verifyUrl | string | — | 否 | 3DS 认证 URL(需引导持卡人验证) |
是 必定返回 · 否 条件返回 · — 不返回
ZA 预授权场景注意:查询 auth 订单(
captureMode=manual创建的原始订单)时不返回cardBrand/cardLast4/cardCountry/eci,需通过captureInfo找到 capture 订单号后再查询 capture 订单获取卡信息。
#示例
ZA · 卡信息支付下单
适用于:发起即时支付
curl 'https://open-gw-daily.palmpay-inc.com/api/v2/payment/merchant/order/queryStatus' \
-H 'CountryCode: ZA' -H 'Authorization: Bearer xxx' -H 'Content-Type: application/json' \
-d '{
"amount": 10,
"currency": "ZAR",
"notifyUrl": "/callback/payment",
"orderId": "{{$randomAlphaNumeric:32}}",
"callBackUrl": "http://baidu.com?query=tomorrew_will_be_better",
"nonceStr": "",
"cardPayerInfo": "{\"cardNo\":\"4000000000000002\",\"cvv\":\"123\",\"expiryYear\":\"26\",\"expiryMonth\":\"12\",\"holderName\":\"zhangg\",\"rememberCard\":true,\"forceThreeDs\":AUTO}",
"requestTime": 1781247874841,
"accessMode": "direct",
"productType": "bank_card",
"captureMode": "immediate",
"version": "2.0.0.0"
}'{
"respCode": "00000000",
"respMsg": "success",
"data": {
{
"orderNo": "24260612070441956333",
"orderStatus": 1,
"payerAccountId": "27d8db869c0a46dfabd6260ec8526ae9",
"mockCheckoutUrl": "https://checkout-daily.palmpay.com/h5-checkout/mock_test?countryCode=ZA&payToken=BD705B2670481166A40322457790B009&orderNo=24260612070441956333&signKey=SyHWTYv5aa94OiK2DR--tFI3RnyR5os1GFHq1ThVuxc&signSession=24260612070441956333&appId=L251103101598045421481&productType=bank_card",
"cardToken": "27d8db869c0a46dfabd6260ec8526ae9",
"merchantName": "caojiangling",
"sdkSignKey": "SyHWTYv5aa94OiK2DR--tFI3RnyR5os1GFHq1ThVuxc",
"orderAmount": 10,
"sdkSessionId": "24260612070441956333",
"appId": "L251103101598045421481",
"currency": "ZAR",
"verifyUrl": "https://ng-apptest.transspay.net/api/finance-switch-adapter/order/3ds-auth-html?upstreamRequestId=20260612D01120304310000000264581717160101&checkSum=e27f242b647939694eb50a4fdaa301938ce471333d3c0e50bf458627bafd2849",
"goodsName": "Order",
"merchantNo": "124073009021701",
"payToken": "BD705B2670481166A40322457790B009"
}
}
}