#支付代充
#请求接口路径
[POST] /api/v2/bill-payment/order/create#参数列表
| 名称 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| sceneCode | String | - | 是 | 业务场景码【详见 场景码】 |
| outOrderNo | String | 64 | 是 | 商户订单号,由商家自定义,32 个字符以内,仅支持字母、数字、下划线且需保证在商户端不重复 |
| amount | Long | - | 是 | 订单总金额(单位) |
| notifyUrl | String | 200 | 是 | 支付通知回调 URL |
| billerId | String | 32 | 是 | 运营商 ID |
| itemId | String | 32 | 是 | 套餐 ID |
| rechargeAccount | String | 15 | 是 | 充值账号 (手机号补零) |
| title | String | 50 | 否 | 订单标题 |
| description | String | 200 | 否 | 订单描述 |
| relationId | String | 64 | 否 | 用户自定义关联 ID |
#返回值
#Postman 请求示例
#request
curl 请求
curl --location 'https://open-gw-sandbox.palmpay-inc.com/api/v2/bill-payment/order/create' \
--header 'Accept: application/json, text/plain, */*' \
--header 'CountryCode: NG' \
--header 'Authorization: Bearer 10241024' \
--header 'Signature: D11A3E8CB478C0B0F40276DDA5AFD898' \
--header 'Content-Type: application/json' \
--data '{
"requestTime": 1713943883031,
"nonceStr": "w7WDWFze8rfBcy25yb6pXbFf7XirM2DK",
"version": "V2",
"outOrderNo": "MKiPaeQWMk2drrQrBBd6WPtx8wP8aNjx",
"sceneCode": "airtime",
"billerId": "MTN",
"itemId": "5267001812000",
"rechargeAccount": "023409551234900",
"relationId": "isRXw8r68PsQmkSrJJJAtcSrDSCTWPyE",
"amount": 10000,
"notifyUrl": "http://xxx.cn"
}'#response
{
"respCode": "00000000",
"respMsg": "success",
"data": {
"outOrderNo": "P86iMr6AGr2Mzx84QnNP3HC636pFcA10",
"orderNo": "y421t3k8000",
"orderStatus": 1,
"msg": "SUCCESS",
"amount": 8800,
"sceneCode": "airtime"
}
}#公共错误码
#业务错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| SBP.INVALID_PARAMETER | 参数无效 | 检查请求参数,修改后重新发起请求 |
| SBP.INVALID_SCENE_CODE | 场景码无效 | 检查场景码,修改后重新发起请求 |
| SBP.BILLER_DISABLE | 运营商不可用 | 检查运营商 ID 是否正确或者运营商状态是否可用 |
| SBP.ITEM_DISABLE | 套餐不可用 | 检查套餐 ID 是否正确或者套餐状态是否可用 |
| SBP.BILLER_ITEM_MISMATCH | 运营商与套餐不匹配 | 检查运营商 ID 与 套餐 ID 是否匹配 |
| SBP.AMOUNT_ABOVE_MAX_LIMIT | 充值金额高于上限 | 充值金额要低于最高金额 |
| SBP.AMOUNT_BELOW_MIN_LIMIT | 充值金额低于下限 | 充值金额要高于最低金额 |
| SBP.AMOUNT_MISMATCH | 充值金额与套餐金额不一致 | 套餐为固定充值金额时,充值金额与套餐金额要一致 |
| SBP.MERCHANT_ERROR | 商户异常 | 检查商户是否正常 |
| SBP.MERCHANT_ACCOUNT_ERROR | 商户账户异常 | 检查商户账户状态是否正常 |
| SBP.MERCHANT_ACCOUNT_STATUS_ERROR | 商户账户状态异常 | 检查商户账户状态是否正常 |
| SBP.MERCHANT_ACCOUNT_BALANCE_NOT_ENOUGH | 商户账户余额不足 | 检查商户账户余额是否充足 |
| SBP.TRADE_HAD_DEAL | 外部商户订单号重复 | 检查传入的交易号是否正确,修改后重新发起请求 |