错误

Ping++ API 使用 HTTP 状态码 (status code) 来表明一个 API 请求的成功或失败状态。返回 HTTP 2XX 表明 API 请求成功。返回 HTTP 4XX 表明在请求 API 时提供了错误信息,例如参数缺失、参数错误、支付渠道错误等。返回 HTTP 5XX 表明 API 请求时,Ping++ 服务器发生了错误。

HTTP 返回状态码

状态码描述
200 - OK一切正常。
400 - Bad Request一般由缺失参数,参数格式不正确等引起。
401 - Unauthorized没有提供正确的 API Key。
402 - Request Failed参数格式正确但是请求失败,一般由业务错误引起。
403 - Forbidden调用接口超过 Ping++ 套餐的并发限制,请 升级套餐 或限流。
404 - Not Found请求的资源不存在。
500, 502, 503, 504 - Server ErrorsPing++ 服务器出错。

错误汇总

返回属性描述
type错误类型,可以是 invalid_request_errorapi_errorchannel_errorcard_error
message返回具体的错误描述。
code optional错误码,由第三方支付渠道返回的错误代码。
param optional当发生参数错误时返回具体的参数名,如 id。

错误类型 (type)

错误类型描述
invalid_request_error请求错误,传入了不正确的地址,参数或值。
api_errorPing++ 服务器出现的异常错误。
channel_error第三方支付渠道出现的错误导致请求出现错误。通常你需要对这些可能出现的情况进行处理或者联系我们。

错误码 (code)

错误码描述
charge_closed支付订单已结束,不能进行后续操作。
charge_unexpected_status支付返回意外的状态码。
refund_wait_operation退款需要等待用户进一步操作。
refund_refused退款失败,被支付渠道拒绝。
refund_retry退款失败,需要重新发起退款。
refund_manual_intervention退款失败,需要通过线下或转账进行退款。
refund_unexpected_status退款返回意外的状态码。
channel_connection_error支付渠道通讯异常。
channel_request_error请求支付渠道接口失败。
channel_parse_error支付渠道返回意外的数据格式发生的解析错误。
channel_sign_error支付渠道返回的数据没有通过签名验证。
channel_unexpected_error支付渠道遇到未知错误。
channel_parameter_error支付渠道参数错误。
channel_auth_error支付渠道参数错误
channel_response_code_fail支付渠道响应码错误。
channel_parameters_consistency_error支付渠道参数一致性检测失败。
channel_not_support_red_envelope您的微信参数版本不支持发送红包。请联系微信升级为新版本。
channel_not_support_transfer您的微信参数版本不支持发送企业付款。请联系微信升级为新版本。
channel_request_info来自渠道的信息
query_right_error支付渠道查询权限错误,请登录支付宝在线人工窗口,免费签约“账务明细”接口和“交易查询”接口。
channel_notify_id_error支付渠道的NOTIFY ID非法或已失效
charge_order_no_used订单号已使用。请用新的订单号发起交易。
transfer_wait_operation转账需要打开地址进行下一步付款操作
refund_refused_msg退款已被支付渠道拒绝。
refund_pending退款状态未明,请稍后查询。
refund_failed退款失败
refund_info_from_channel来自渠道的退款信息。
refund_not_found未在渠道查找到相应退款信息。
red_system_busy支付渠道系统繁忙,请稍后用同一商户单号再次调用。只会发送一个红包。
transfer_system_busy支付渠道系统繁忙,请稍后用同一商户单号再次调用。只会发送一笔转账。