• 简体中文
  • 查询套餐

    请求接口路径

    [POST] /api/v2/bill-payment/item/query

    参数列表

    名称类型长度必填描述
    sceneCodeString-是业务场景码【详见 场景码】
    billerIdString32是运营商 ID

    返回值

    名称类型长度必填描述
    billerIdString32是运营商 ID
    itemIdString32是套餐 ID
    itemNameString32是套餐名称
    amountLong-否套餐金额
    minAmountLong-否套餐充值金额下限
    maxAmountLong-否套餐充值金额上限
    isFixAmountInteger-否是否固定金额 0-非固定金额 1-固定金额
    statusInteger-否状态 0 1
    extInfoObject-否扩展参数
    extInfo 对象字段类型长度必填描述
    validityDateLong-否套餐有效天数
    itemSizeString32否套餐大小
    itemDescriptionString32否套餐的使用说明

    Postman 请求示例

    request

    curl 请求

    curl --location 'https://open-gw-sandbox.palmpay-inc.com/api/v2/bill-payment/item/query' \
    --header 'Accept: application/json, text/plain, */*' \
    --header 'CountryCode: NG' \
    --header 'Authorization: Bearer 10241024' \
    --header 'Signature: D11A3E8CB478C0B0F40276DDA5AFD898' \
    --header 'Content-Type: application/json' \
    --data '{"requestTime":1713924195586,"nonceStr":"6brpMN6ekD2kxZb2Xz7XQehadenFn8d3","version":"V2","billerId":"MTN","sceneCode":"airtime"}'

    response

    {
      "respCode": "00000000",
      "respMsg": "success",
      "data": [
        {
          "billerId": "MTN",
          "itemId": "5267001812",
          "itemName": "MTN Adaptable Amount",
          "amount": 10000,
          "maxAmount": null,
          "minAmount": null,
          "isFixAmount": 0,
          "status": 1
        }
      ]
    }

    公共错误码

    参见此文

    业务错误码

    错误码错误描述解决方案
    SBP.INVALID_PARAMETER参数无效检查请求参数,修改后重新发起请求
    SBP.INVALID_SCENE_CODE场景码无效检查场景码,修改后重新发起请求
    SBP.BILLER_DISABLE运营商不可用检查运营商 ID 是否正确或者运营商状态是否可用