# API 响应码列表

# 说明

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

# 示例

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

# 通用接口错误码

错误码 内部错误码 错误信息
10000 SUCCESS Success
21000 OPI_GENERAL_ERROR Server error, Please try again later.
21001 OPI_SIGN_ERROR Request sign error
21002 OPI_PARAM_ERROR Request param error
21003 OPI_APPID_ERROR Request appId error
21004 OPI_MCH_ERROR Merchant is unavailable
21005 OPI_MCH_CHANNEL_UNAVAILABLE_ERROR Merchant channel is unavailable
21006 OPI_MCH_TX_NOT_FOUND Merchant transaction not found
21007 OPI_DUPLICATE_MCH_ORDER_ID Duplicate merchant order id
21008 OPI_TIMESTAMP_ERROR Request timestamp error
21009 OPI_TIMESTAMP_EXPIRED_ERROR Request timestamp error
21010 OPI_AMOUNT_EXCEED_ERROR The amount exceeds the limit
21011 OPI_NETWORK_ERROR Network error
21012 OPI_BANK_CODE_ERROR Request bank code error
21013 OPI_EWALLET_CODE_ERROR Request wallet code error
21014 OPI_BALANCE_ERROR Merchant balance insufficient
21015 OPI_DUPLICATE_IDEMPOTENCY_ID Duplicate idempotencyId
21016 OPI_MCH_IP_ERROR Merchant ip forbidden

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

错误码 内部错误码 错误信息
215xx OPI_GENERAL_ERROR Server error, Please try again later.

# 退款接口错误码

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

# 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 错误提示语
-10000 Transaction Service Error
-10001 Transaction Exceed Limit
-10002 Transaction Params Error
-10003 Transaction Insufficient Balance
-10004 Transaction Channel Rejected
-10005 Transaction Destination Account Error
-10006 Transaction Network Reject
-10007 Transaction Channel Temporarily Close
-10008 Merchant Unavailable Error
-10009 Recipient Account Blocked
-10010 Channel Refund Failed

# Open API 交易状态枚举列表

  • 同用于代收和代付
transactionStatus 交易状态 说明
PENDING 交易中
COMPLETED 交易完成
FAILED 交易失败