• 简体中文
  • 支付代充

    请求接口路径

    [POST] /api/v2/bill-payment/order/create

    参数列表

    名称类型长度必填描述
    sceneCodeString-是业务场景码【详见 场景码】
    outOrderNoString64是商户订单号,由商家自定义,32 个字符以内,仅支持字母、数字、下划线且需保证在商户端不重复
    amountLong-是订单总金额(单位)
    notifyUrlString200是支付通知回调 URL
    billerIdString32是运营商 ID
    itemIdString32是套餐 ID
    rechargeAccountString15是充值账号 (手机号补零)
    titleString50否订单标题
    descriptionString200否订单描述
    relationIdString64否用户自定义关联 ID

    返回值

    名称类型长度必填描述
    outOrderNoString64是商户订单号
    orderNoString32是PalmPay 平台订单号
    orderStatusInteger2是订单状态【详见 订单状态】
    msgString8否状态描述信息
    amountLong-是订单总金额(单位)
    sceneCodeString-是业务场景码【详见 场景码】

    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外部商户订单号重复检查传入的交易号是否正确,修改后重新发起请求