API Doc
选择语言
选择语言
  • English
  • 简体中文
选择语言
选择语言
  • English
  • 简体中文
    • 统一API请求参数
    • API 响应码列表
    • 统一异步通知参数
    • 1. 账户接口
      • 1. 余额查询
        POST
      • 2. 对账文件下载
        POST
    • 2. 代付接口
      • 代付渠道列表
      • 2.1 代付下单接口
        POST
      • 2.2 查询代付状态接口
        POST
      • 2.3 代付回调接口
        POST
    • 3. QR Code
      • QR Code 渠道码列表
      • 3.1 QR Code 创建
        POST
      • 3.2 QR Code 详情查询
        POST
      • 3.3 QR Code 还款查询
        POST
      • 3.4 QR Code 还款通知
        POST
      • 3.5 QR Code 取消
        POST
    • 4. WebPay 接口
      • WebPay渠道列表
      • 微信网页授权说明
      • 微信调起支付说明
      • 4.1 WebPay收款下单
        POST
      • 4.2 WebPay查询收款状态
        POST
      • 4.3 WebPay回调通知
        POST
    • 5. 退款接口
      • 退款支持列表
      • 退款状态枚举
      • 5.1 退款接口
        POST
      • 5.2 退款查询接口
        POST
      • 5.3 退款回调接口
        POST
    • 6. 撤销接口
      • 交易撤销渠道列表
      • 6.1 交易撤销接口
    • 7 授权代扣接口
      • 授权代扣渠道列表
      • 获取授权链接
      • 查询授权状态
      • 取消授权
      • 授权通知
      • 代扣下单接口
      • 代扣订单详情接口
      • 扣款通知

    API 响应码列表

    说明#

    BluePay Open API 接口返回的错误码集合。

    示例#

    {
        "code": 21000,
        "message": "Server error, Please try again later."
    }

    通用接口错误码#

    错误码内部错误码错误信息
    10000SUCCESSSuccess
    21000OPI_GENERAL_ERRORServer error, Please try again later.
    21001OPI_SIGN_ERRORRequest sign error
    21002OPI_PARAM_ERRORRequest param error
    21003OPI_APPID_ERRORRequest appId error
    21004OPI_MCH_ERRORMerchant is unavailable
    21005OPI_MCH_CHANNEL_UNAVAILABLE_ERRORMerchant channel is unavailable
    21006OPI_MCH_TX_NOT_FOUNDMerchant transaction not found
    21007OPI_DUPLICATE_MCH_ORDER_IDDuplicate merchant order id
    21008OPI_TIMESTAMP_ERRORRequest timestamp error
    21009OPI_TIMESTAMP_EXPIRED_ERRORRequest timestamp error
    21010OPI_AMOUNT_EXCEED_ERRORThe amount exceeds the limit
    21011OPI_NETWORK_ERRORNetwork error
    21012OPI_BANK_CODE_ERRORRequest bank code error
    21013OPI_EWALLET_CODE_ERRORRequest wallet code error
    21014OPI_BALANCE_ERRORMerchant balance insufficient
    21015OPI_DUPLICATE_IDEMPOTENCY_IDDuplicate idempotencyId
    21016OPI_MCH_IP_ERRORMerchant ip forbidden

    独立业务接口错误码 (BluePay:215xx)#

    错误码内部错误码错误信息
    215xxOPI_GENERAL_ERRORServer error, Please try again later.

    退款接口错误码#

    响应码响应信息
    21401Refund is processing
    21402Not allowed to refund
    21403Transactions 60 days ago cannot initiate refunds
    21404The original transaction channel not support full refund
    21405The original transaction channel not support partial refund
    21406Refund amount invalid
    21407MchRefundOrderId is repeat
    21408The original transaction is not completed
    21409The original transaction already exist pending refund

    撤销接口响应码#

    响应码响应信息
    21500Original transaction status is not success
    21501Cannot reverse
    21502Original transaction has been settled
    21503Cannot void over the day
    21504Original transaction has been already voided
    21504Duplicate mchVoidOrderID detected. Please provide a unique mchvoidOrderID and retry.

    Open API 交易Failed Code 错误码列表#

    用于交易查询或者回调结果
    响应示例
    {
    	"amount":5735,
    	"createTime":"2022-01-10 17:55:45",
    	"eventName":"disbursement.failed",
    	"failedCode":-10001,
    	"failedMessage":"Transaction Exceed Limit",
    	"mchOrderId":"CCP16418085446081",
    	"remark":"cash credit",
    	"returnTime":"2022-01-10 18:33:37",
    	"sign":"5a9dd499ddf1c2a4dcf054aceafe409b45f37ca6",
    	"transactionId":"d149b0a575e5344740b2d9698babcede1f68",
    	"transactionStatus":"FAILED"
    }
    错误failedCode错误提示语
    -10000Transaction Service Error
    -10001Transaction Exceed Limit
    -10002Transaction Params Error
    -10003Transaction Insufficient Balance
    -10004Transaction Channel Rejected
    -10005Transaction Destination Account Error
    -10006Transaction Network Reject
    -10007Transaction Channel Temporarily Close
    -10008Merchant Unavailable Error
    -10009Recipient Account Blocked
    -10010Channel Refund Failed

    Open API 交易状态枚举列表#

    同用于代收和代付
    transactionStatus 交易状态说明
    PENDING交易中
    COMPLETED交易完成
    FAILED交易失败
    上一页
    统一API请求参数
    下一页
    统一异步通知参数
    Built with