API 响应代码

当您向我们的 API 发出请求时，您将收到一个 HTTP 状态代码，表明 HTTP 请求是否成功。

如果您收到成功的 2xx HTTP 响应，则响应主体中包含一个 response_code 字段，表明请求状态。该响应的 response_summary 和 status 字段中可能还包含附加信息。

如果您收到的是不成功的 4xx HTTP 响应，则响应主体中可能包含一个 error_codes 字段。错误代码说明了请求失败的原因。

信息响应代码的文字信息在不同的端点（Endpoint）响应中可能会有所不同。

响应代码范围

响应代码有五位数，根据代码类型分成不同的代码范围：

10xxx - APPROVED（已批准）

信息响应代码消息文本可能会因不同的端点响应而有所不同。

*部分授权

20xxx - SOFT DECLINE（软拒绝）

信息响应代码消息文本可能会因不同的端点响应而有所不同。

*建议代码 MADA 交易中的格式错误

30xxx - HARD DECLINE（硬拒绝）

信息响应代码消息文本可能会因不同的端点响应而有所不同。

‍

40xxx - RISK RESPONSES（风险响应）

风险响应由我们的风险引擎触发。

信息响应代码消息文本可能会因不同的端点响应而有所不同。

50xxx - CHECKOUT.COM DECLINE（Checkout.com 拒绝）

信息响应代码消息文本可能会因不同的端点响应而有所不同。

已拒绝 - 不接受付款

Declined - Do not honour（已拒绝 - 不予兑付）通知是与 20005 响应代码相关的请求状态，表示客户的银行已拒绝付款。这是银行在付款授权失败时发出的最常见报文。

此拒绝响应意味着发卡行未提供有关付款失败的进一步详细信息，且我们无法覆写该响应。

付款可能已因 CVV 或 AVS 检查失败而被拒绝，因此在尝试其他操作之前，请检查这些字段是否正确。

触发场景

有几种可能的场景会触发 20005 (Declined - Do not honour) 响应代码：

1. 银行的欺诈规则（考虑了各种未公开的因素）已被触发。
2. 银行可能已暂时锁定客户的卡。
3. 由于多次拒绝付款，购买会话可能已被锁定。
4. 卖方位于与发卡行不同的国家。

响应的解决

要解决 20005 (Declined - Do not honour) 响应，请尝试以下操作：

1. 建议客户联系其银行，说明他们正在尝试处理付款。客户可以要求银行允许付款。
2. 建议客户稍后再次尝试。发卡行可能只是暂时锁定该卡。
3. 建议客户使用替代信用卡。

原始响应代码（Beta 版）

Checkout.com 的标准化响应代码适用于不同的卡组织和付款方式，便于集成和交易分析。

对于卡支付，我们还提供卡组织发送的原始授权响应代码，位于该响应的 partner_response_code 字段中。这也称为原始响应代码。

下列情况将返回 Partner_response_code 字段：

POST

 Request a payment 响应

GET

 Get payment details 响应

• Webhook 通知

信息要启用 partner_response_code 功能，请联系您的客户经理或 support@checkout.com。不同卡组织的数值有所不同，可能会有更改。有关详情，请参阅卡组织的文档。

付款响应示例

VisaMastercardAmex

{
  "response_code": "20051",
  "response_summary": "Insufficient funds",
  "processing": {
    "scheme": "visa",
    "partner_response_code": "51"
  }
}

Webhook 示例

1{
2  "id": "pay_tb4f46qcj6runb3pmbsrrdqd74",
3  "action_id": "act_ixmhjuu4brpu7lw4dkny4bfcam",
4  "amount": 0,
5  "auth_code": "656280",
6  "currency": "EUR",
7  "payment_type": "Regular",
8  "processed_on": "2023-12-15T16:50:16.9557112Z",
9  "processing": {
10    "acquirer_transaction_id": "371551175125650580188",
11    "retrieval_reference_number": "583063115397",
12    "scheme": "MASTERCARD",
13    "partner_response_code": "51"
14  },
15  "response_code": "20051",
16  "response_summary": "Insufficient Funds",
17  "risk": {
18    "flagged": false
19  },
20  "scheme_id": "885825379894893",
21  "source": {
22    "id": "src_u3p3boigodfu3hcqo6ini2ofwe",
23    "type": "card",
24    "billing_address": {},
25    "expiry_month": 10,
26    "expiry_year": 2028,
27    "scheme": "MASTERCARD",
28    "last_4": "9682",
29    "fingerprint": "3C2C9685923907BAC9BB646F83E3799E40FC628147F25F76745A0B9296D769AC",
30    "bin": "543782",
31    "card_type": "CREDIT",
32    "card_category": "CONSUMER",
33    "issuer": "TAISHIN INTERNATIONAL BANK",
34    "issuer_country": "TW",
35    "product_id": "MCS",
36    "product_type": "Standard MasterCard(r) Card",
37    "avs_check": "S",
38    "cvv_check": "Y"
39  },
40  "event_links": {
41    "payment": "https://api.sandbox.checkout.com/payments/pay_tb4f46qcj6runb3pmbsrrdqd74",
42    "payment_actions": "https://api.sandbox.checkout.com/payments/pay_tb4f46qcj6runb3pmbsrrdqd74/actions"
43  },
44  "action_invocations": [
45    {
46      "workflow_id": "wf_wdodk5vudmrubb5us6zefyaepe",
47      "workflow_action_id": "wfa_zb7vtvprtipu5l3trvk2m7je6y",
48      "status": "successful",
49      "_links": {
50        "self": {
51          "href": "https://api.sandbox.checkout.com/workflows/events/evt_igyyma6msoledm57qy4efdihhy/actions/wfa_zb7vtvprtipu5l3trvk2m7je6y"
52        }
53      }
54    }
55  ],
56  "_links": {
57    "self": {
58      "href": "https://api.sandbox.checkout.com/workflows/events/evt_igyyma6msoledm57qy4efdihhy"
59    },
60    "payment_actions": {
61      "href": "https://api.sandbox.checkout.com/payments/pay_tb4f46qcj6runb3pmbsrrdqd74/actions"
62    },
63    "payment": {
64      "href": "https://api.sandbox.checkout.com/payments/pay_tb4f46qcj6runb3pmbsrrdqd74"
65    }
66  }
67}

HTTP 状态代码

下表描述了发送 API 请求时可能收到的 HTTP 响应代码。

欢迎阅读英文原文支持文章，并了解相关的常见问题解答。