#创建订单
#请求路径
/api/v2/payment/merchant/createorder#参数列表
| 名称 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| orderId | string | 32 | 是 | 商户唯一订单号,可用于查询交易结果 |
| title | string | 100 | 否 | 订单标题 |
| description | string | 200 | 否 | 订单描述 |
| userId | string | 50 | 否 | 用户在商户端的唯一id |
| userMobileNo | String | 15 | 否 | 用户手机号码,在收银台页面会回填输入框 兼容多种格式 e.g. 07011698742 or 7011698742 or 023407011698742 or 02347011698742 区号格式 |
| amount | Long | - | 是 | 交易金额(最小单位为分) 最小金额:100NGN |
| currency | String | 10 | 是 | 货币(NGN) |
| notifyUrl | string | 200 | 是 | 接收交易结果通知url |
| callBackUrl | string | 200 | 是 | 支付完成后H5页面返回商户指定url地址 |
| orderExpireTime | Integer | - | 否 | 订单有效期时长,单位:秒 即未付款订单的过期时间,默认值:1800(30分钟) 区间:1800s≤orderExpireTime≤86400s (最长不为24小时,最短为30mins) |
| remark | string | 200 | 否 | 备注信息 |
| goodsDetails | String | - | 是/否 | JSONArray string格式,详见:商品详情列表(GoodsDetail);国际客户必填 |
| customerInfo | String | - | 是 | JSON string格式,详见:客户信息(CustomerInfo) |
| productType | string | 100 | 是 | 固定传bank_transfer |
| splitDetail | String | - | 否 | JSON string格式,详见:分账详情,如果需要分账,则必填 |
| extraFieldList | String | - | 否 | 扩展字段,JSON array格式,列表最大长度为5,会在订单详情页及订单导出中展示 |
#返回值
| 名称 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| orderNo | string | 32 | 是 | PalmPay平台订单号 |
| orderStatus | Integer | 20 | 是 | 订单状态(见订单状态) |
| message | string | 50 | 否 | 状态描述信息 |
| checkoutUrl | string | 200 | 否 | 拉起H5支付的url |
| payerAccountType | Integer | 20 | 否 | 账户类型(pay with bank transfer使用-1) |
| payerAccountId | string | 200 | 否 | 账户唯一id(当-1时返回) |
| payerBankName | string | 200 | 否 | 虚拟账户的银行(当-1时返回) |
| payerAccountName | string | 200 | 否 | 虚拟账户的名字(当-1时返回) |
| payerVirtualAccNo | string | 200 | 否 | 虚拟账户号(当-1时返回) |
| payToken | String | 200 | 是 | 拉起SDK支付需要的参数 |
| sdkSessionId | String | 32 | 是 | 安全动态秘钥拉起SDK所需参数 |
| sdkSignKey | String | 32 | 是 | 安全动态秘钥拉起SDK所需参数 |
| currency | String | 10 | 是 | 货币代码(NGN、GHS、TZS、KES、ZAR) |
| orderAmount | Long | - | 是 | 交易金额(最小单位计量) |
Remark:
如需自定义页面,可以使用📄查询订单结果该接口获取订单页面参数(包含订单状态,虚拟号,有效期等信息)
#错误码
#Postman请求示例
#request
curl --location 'https://open-gw-sandbox.palmpay-inc.com/api/v2/payment/merchant/createorder' \
--header 'Accept: application/json, text/plain, */*' \
--header 'CountryCode: NG' \
--header 'Authorization: Bearer 10241024' \
--header 'Signature: D11A3E8CB478C0B0F40276DDA5AFD898' \
--header 'Content-Type: application/json' \
--data '{
"requestTime":1662171389940,
"version":"V1.1",
"nonceStr":"IBJGAeTa4ZJQv4Z2qufomVo9eI1YnJ9Y",
"amount":200,
"notifyUrl":"https://xx.cn/callback/payment",
"orderId":"testc9ffae997fc1",
"title":"pay",
"description": "pay some thing",
"userId":"110",
"userMobileNo":"07011698742",
"currency": "NGN",
"callBackUrl": "http://returnurl",
"goodsDetails": "[{\"goodsId\": \"1\"}]",
"productType":"bank_transfer",
"splitDetail": "{\"isSplit\":true,\"splitAmountType\":1,\"splitFeeType\":1,\"splitMerchantList\":[{\"splitMerchantId\":\"A\",\"splitAmount\":100,\"remark\":\"A商户被分账1奈拉\"},{\"splitMerchantId\":\"B\",\"splitAmount\":100,\"remark\":\"B商户被分账1奈拉\"}]}",
"extraFieldList": "[\"123\",\"456\"]"
}'#response
{
"respCode": "00000000",
"respMsg": "success",
"data": {
"orderNo": "2424220903032435363613",
"orderStatus": 1,
"message": "success",
"checkoutUrl": "https://openapi.transspay.net/open-api/api/v1/payment/h5/redirect?orderNo=2424220903032435363613&userId=110&sign=18FC68963B01E5B2EBE71A59F5D70AE70D66D4798F11B1632B08B4EB084948DC&key=4cca233f40b1dfb1b4600c7dfdaf3ee2",
"payMethod": "bank_transfer",
"orderAmount": 200,
"currency": "NGN",
"payerBankName": "PalmPay",
"payerVirtualAccNo": "8754982724",
"payerAccountName": "testMerchantName(Pay NGN 2.00)"
}
}