#创建订单
#请求接口路径
/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(30mins) 区间:1800s≤orderExpireTime≤86400s (最长不为24小时,最短为30mins) |
| goodsDetails | String | - | 是/否 | JSONArray string格式,详见:商品详情列表(GoodsDetail);国际客户必填 |
| customerInfo | String | - | 是 | JSON string格式,详见:客户信息(CustomerInfo) |
| remark | String | 200 | 否 | 备注信息 |
| productType | String | 100 | 是 | 固定传 pay_wallet |
| openId | String | 100 | 否 | 需要配合授权使用,可实现用户免登录 授权接口 |
| splitDetail | String | - | 否 | JSON string格式,详见:分账详情,如果需要分账,则必填 |
| extraFieldList | String | - | 否 | 扩展字段,JSON array格式,列表最大长度为5,会在订单详情页及订单导出中展示 |
| evokeAndroid | Boolean | - | 否 | 配置是否拉起PalmPay Android客户端完成支付;传值“true”代表拉端支付,“false”代表不拉端支付。若不传值,则按照系统配置 |
| evokeIos | Boolean | - | 否 | 配置是否拉起PalmPay iOS客户端完成支付;传值“true”代表拉端支付,“false”代表不拉端支付。若不传值,则按照系统配置 |
#返回值
#错误码
#Postman请求示例
#request
curl请求
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":"pay_wallet",
"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",
"payToken": "eyJvcmRlck5vIjoiMjQyNDIyMDkwMzAzMjQzNTM2MzYxMyIsInVzZXJJZCI6IjExMCIsInNpZ24iOiIxOEZDNjg5NjNCMDFFNUIyRUJFNzFBNTlGNUQ3MEFFNzBENjZENDc5OEYxMUIxNjMyQjA4QjRFQjA4NDk0OERDIiwia2V5IjoiNGNjYTIzM2Y0MGIxZGZiMWI0NjAwYzdkZmRhZjNlZTIifQ==",
"sdkSessionId":"3032435363613",
"sdkSignKey": "110",
"orderAmount": 200,
"currency": "NGN"
}
}