Ping++ API 使用 HTTP 状态码 (status code) 来表明一个 API 请求的成功或失败状态。返回 HTTP 2XX
表明 API 请求成功。返回 HTTP 4XX
表明在请求 API 时提供了错误信息,例如参数缺失、参数错误、支付渠道错误等。返回 HTTP 5XX
表明 API 请求时,Ping++ 服务器发生了错误。
状态码 描述 200 - OK 一切正常。 400 - Bad Request 一般由缺失参数,参数格式不正确等引起。 401 - Unauthorized 没有提供正确的 API Key。 402 - Request Failed 参数格式正确但是请求失败,一般由业务错误引起。 403 - Forbidden 调用接口超过 Ping++ 套餐的并发限制,请 升级套餐 或限流。 404 - Not Found 请求的资源不存在。 500, 502, 503, 504 - Server Errors Ping++ 服务器出错。
返回属性 | 描述 |
---|---|
type | 错误类型,可以是 invalid_request_error 、api_error 、channel_error 或 card_error 。 |
message | 返回具体的错误描述。 |
code optional | 错误码,由第三方支付渠道返回的错误代码。 |
param optional | 当发生参数错误时返回具体的参数名,如 id。 |
错误类型 描述 invalid_request_error 请求错误,传入了不正确的地址,参数或值。 api_error Ping++ 服务器出现的异常错误。 channel_error 第三方支付渠道出现的错误导致请求出现错误。通常你需要对这些可能出现的情况进行处理或者联系我们。
错误码 描述 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 支付渠道系统繁忙,请稍后用同一商户单号再次调用。只会发送一笔转账。