• 新平台

该接口用于支付完成后获取支付结果使用。
https://api-reference.checkout.com/#operation/getPaymentDetails

HTTP调用方式为Get

通过pay | sid_id 查询支付结果

沙箱环境地址：https://api.sandbox.checkout.com/payments/{id}
生产环境地址：https://api.checkout.com/payments/{id}
通过URL中添加Path参数来获取指定支付的最新状态

Path 参数名 是否必填 说明
id
- [x]

| 正则表达式：^(pay|sid)_(\w{26})$

该id为调用Create HPP或者Payment完成支付后返回。
具体见后文如何获取pay ｜ sid id |

成功返回报文示例：

  1. GET https://api.sandbox.checkout.com/payments/pay_g26ap2k3dtt2vdx5shygqfsk2e
  3. {
  4.   "id": "pay_g26ap2k3dtt2vdx5shygqfsk2e",
  5.   "requested_on": "2022-04-24T03:30:12Z",
  6.   "source": {
  7.     "id": "src_3t5guzlqpsyuxliofkvgbodcxy",
  8.     "type": "card",
  9.     "billing_address": {
  10.       "country": "US"
  11.     },
  12.     "expiry_month": 1,
  13.     "expiry_year": 2023,
  14.     "name": "L L",
  15.     "scheme": "Visa",
  16.     "last4": "4242",
  17.     "fingerprint": "038243847473D6ABE9CDF2E1E812A656CC71C3A5552C09CB3D1FE6E3AC676C84",
  18.     "bin": "424242",
  19.     "card_type": "Credit",
  20.     "card_category": "Consumer",
  21.     "issuer": "JPMORGAN CHASE BANK NA",
  22.     "issuer_country": "US",
  23.     "product_id": "A",
  24.     "product_type": "Visa Traditional",
  25.     "avs_check": "S",
  26.     "cvv_check": "Y",
  27.     "payouts": true,
  28.     "fast_funds": "d"
  29.   },
  30.   "amount": 5000,
  31.   "currency": "EUR",
  32.   "payment_type": "Regular",
  33.   "reference": "abc-123",
  34.   "status": "Captured",
  35.   "approved": true,
  36.   "3ds": {
  37.     "downgraded": false,
  38.     "enrolled": "Y",
  39.     "authentication_response": "Y",
  40.     "cryptogram": "3ec010c5-df25-4c6e-be52-e4a3",
  41.     "xid": "08f88368-711f-4491-89c5-49c7963174dd",
  42.     "version": "2.1.0"
  43.   },
  44.   "risk": {
  45.     "flagged": false
  46.   },
  47.   "customer": {
  48.     "id": "cus_lygzjadnmwkuvdnmu4ymohd7uy"
  49.   },
  50.   "billing_descriptor": {
  51.     "name": "",
  52.     "city": "London"
  53.   },
  54.   "metadata": {
  55.     "mode": "payment",
  56.     "cancel_url": "http://127.0.0.1:3000/result",
  57.     "correlationId": "4d28f42c-1bdb-4a28-87a9-c69db0ab7129",
  58.     "correlation_id": "4d28f42c-1bdb-4a28-87a9-c69db0ab7129"
  59.   },
  60.   "eci": "05",
  61.   "scheme_id": "956063208697024",
  62.   "actions": [
  63.     {
  64.       "id": "act_fha4huunf6mkvmcsxjnqb3st7q",
  65.       "type": "Capture",
  66.       "response_code": "10000",
  67.       "response_summary": "Approved"
  68.     },
  69.     {
  70.       "id": "act_g26ap2k3dtt2vdx5shygqfsk2e",
  71.       "type": "Authorization",
  72.       "response_code": "10000",
  73.       "response_summary": "Approved"
  74.     }
  75.   ],
  76.   "_links": {
  77.     "self": {
  78.       "href": "https://api.sandbox.checkout.com/payments/pay_g26ap2k3dtt2vdx5shygqfsk2e"
  79.     },
  80.     "actions": {
  81.       "href": "https://api.sandbox.checkout.com/payments/pay_g26ap2k3dtt2vdx5shygqfsk2e/actions"
  82.     },
  83.     "refund": {
  84.       "href": "https://api.sandbox.checkout.com/payments/pay_g26ap2k3dtt2vdx5shygqfsk2e/refunds"
  85.     }
  86.   }
  87. }

通过reference查询支付结果

也可以通过增加param来获取指定支付的最新状态
沙箱环境地址：https://api.sandbox.checkout.com/payments?reference={{reference}}
生产环境地址：https://api.checkout.com/payments?reference={{reference}}

Param 参数名 是否必填 说明
reference
- [x]

| reference为原Payment请求中商户侧的订单id |

当商户发送了重复的reference时，查询结果中会以数组的形式返回所有支付单信息。

成功返回报文示例-存在唯一reference：

  1. {
  2.     "total_count": 1,
  3.     "skip": 0,
  4.     "limit": 10,
  5.     "data": [
  6.         {
  7.             "id": "pay_wcxurpsg7ui2dbuwx2mnhn23b4",
  8.             "requested_on": "2022-06-29T09:22:53Z",
  9.             "source": {
  10.                 "id": "src_hdsc6vjgjnwexphsly46tbuu6e",
  11.                 "type": "card",
  12.                 "billing_address": {
  13.                     "country": "HK"
  14.                 },
  15.                 "expiry_month": 2,
  16.                 "expiry_year": 2023,
  17.                 "scheme": "Visa",
  18.                 "last4": "4242",
  19.                 "fingerprint": "67CF46597CE027875ED8230F168703A1D49E8D10622180AE58BB08813B3233D3",
  20.                 "bin": "424242",
  21.                 "card_type": "Credit",
  22.                 "card_category": "Consumer",
  23.                 "issuer": "JPMORGAN CHASE BANK NA",
  24.                 "issuer_country": "US",
  25.                 "product_id": "A",
  26.                 "product_type": "Visa Traditional",
  27.                 "avs_check": "S",
  28.                 "cvv_check": "Y",
  29.                 "payouts": true,
  30.                 "fast_funds": "d"
  31.             },
  32.             "amount": 300,
  33.             "currency": "USD",
  34.             "payment_type": "Regular",
  35.             "reference": "ORD-TEST-2206",
  36.             "description": "Set of 3 masks",
  37.             "status": "Captured",
  38.             "approved": true,
  39.             "risk": {
  40.                 "flagged": false
  41.             },
  42.             "customer": {
  43.                 "id": "cus_lxuppkhxqzfetaaaoxmjvxeybm",
  44.                 "email": "abc@163.com"
  45.             },
  46.             "billing_descriptor": {
  47.                 "name": "",
  48.                 "city": "London"
  49.             },
  50.             "shipping": {
  51.                 "address": {
  52.                     "address_line1": "Checkout.com",
  53.                     "address_line2": "90 Tottenham Court Road",
  54.                     "city": "London",
  55.                     "state": "London",
  56.                     "zip": "W1T 4TJ",
  57.                     "country": "HK"
  58.                 },
  59.                 "phone": {
  60.                     "country_code": "1",
  61.                     "number": "415 555 2671"
  62.                 }
  63.             },
  64.             "scheme_id": "411080072971738",
  65.             "_links": {
  66.                 "self": {
  67.                     "href": "https://api.sandbox.checkout.com/payments/pay_wcxurpsg7ui2dbuwx2mnhn23b4"
  68.                 },
  69.                 "actions": {
  70.                     "href": "https://api.sandbox.checkout.com/payments/pay_wcxurpsg7ui2dbuwx2mnhn23b4/actions"
  71.                 },
  72.                 "refund": {
  73.                     "href": "https://api.sandbox.checkout.com/payments/pay_wcxurpsg7ui2dbuwx2mnhn23b4/refunds"
  74.                 }
  75.             }
  76.         }
  77.     ]
  78. }

成功返回报文示例-存在多个相同的reference：

  1. Get https://api.sandbox.checkout.com//payments?reference=ORD-Test-2022-23
  3. {
  4.     "total_count": 12,
  5.     "skip": 0,
  6.     "limit": 10,
  7.     "data": [
  8.         {
  9.             "id": "pay_gyhf5oyvhdbutgzol4lscn7kfi",
  10.             "requested_on": "2022-06-23T07:01:41.3999122Z",
  11.             "source": {
  12.                 "type": "card",
  13.                 "expiry_month": 12,
  14.                 "expiry_year": 2025,
  15.                 "scheme": "Visa",
  16.                 "last4": "7863",
  17.                 "fingerprint": "C8A6B037924E78BECC5C76AD6D895D9BE0D43C3030AA079317E554B84E0EB7A3",
  18.                 "bin": "453962",
  19.                 "card_type": "DEBIT",
  20.                 "card_category": "CONSUMER",
  21.                 "issuer": "BANC INTERNACIONAL DANDORRA, S.A.",
  22.                 "issuer_country": "AD"
  23.             },
  24.             "amount": 1005,
  25.             "currency": "USD",
  26.             "payment_type": "Regular",
  27.             "reference": "ORD-Test-2022-23",
  28.             "description": "Set of 3 masks",
  29.             "status": "Declined",
  30.             "approved": false,
  31.             "3ds": {
  32.                 "downgraded": false,
  33.                 "enrolled": "Y",
  34.                 "authentication_response": "N",
  35.                 "version": "2.1.0",
  36.                 "challenged": false
  37.             },
  38.             "risk": {
  39.                 "flagged": false
  40.             },
  41.             "customer": {
  42.                 "id": "cus_57x7gb4wtxquxn3gqye2hujnt4",
  43.                 "email": "123@test.com",
  44.                 "name": "1234567"
  45.             },
  46.             "billing_descriptor": {
  47.                 "name": "SUPERHEROES.COM",
  48.                 "city": "GOTHAM"
  49.             },
  50.             "shipping": {
  51.                 "address": {
  52.                     "address_line1": "Checkout.com",
  53.                     "address_line2": "90 Tottenham Court Road",
  54.                     "city": "London",
  55.                     "state": "London",
  56.                     "zip": "W1T 4TJ",
  57.                     "country": "GB"
  58.                 },
  59.                 "phone": {
  60.                     "country_code": "+1",
  61.                     "number": "415 555 2671"
  62.                 }
  63.             },
  64.             "payment_ip": "111.111.111.1",
  65.             "metadata": {
  66.                 "coupon_code": "NY2018",
  67.                 "partner_id": "123989",
  68.                 "udf1": "1234567"
  69.             },
  70.             "_links": {
  71.                 "self": {
  72.                     "href": "https://api.sandbox.checkout.com/payments/pay_gyhf5oyvhdbutgzol4lscn7kfi"
  73.                 },
  74.                 "actions": {
  75.                     "href": "https://api.sandbox.checkout.com/payments/pay_gyhf5oyvhdbutgzol4lscn7kfi/actions"
  76.                 }
  77.             }
  78.         },
  79.         {
  80.             "id": "pay_ychk42fsoeqefeqbz65ocr55gy",
  81.             "requested_on": "2022-06-23T06:50:27.3871995Z",
  82.             "source": {
  83.                 "id": "src_33yoxu6f6fdujclo33v43oyf6q",
  84.                 "type": "card",
  85.                 "expiry_month": 12,
  86.                 "expiry_year": 2025,
  87.                 "scheme": "Visa",
  88.                 "last4": "4242",
  89.                 "fingerprint": "71580B426F1D190D29087FF265D8F48DF1AD34EDE41C27CBFF9D23C1A14D1776",
  90.                 "bin": "424242",
  91.                 "card_type": "CREDIT",
  92.                 "card_category": "CONSUMER",
  93.                 "issuer_country": "GB",
  94.                 "product_id": "F",
  95.                 "product_type": "Visa Classic",
  96.                 "avs_check": "G",
  97.                 "payment_account_reference": "V001533349648389224"
  98.             },
  99.             "expires_on": "2022-07-23T06:50:39.2830225Z",
  100.             "amount": 1005,
  101.             "currency": "USD",
  102.             "payment_type": "Regular",
  103.             "reference": "ORD-Test-2022-23",
  104.             "description": "Set of 3 masks",
  105.             "status": "Captured",
  106.             "approved": true,
  107.             "3ds": {
  108.                 "downgraded": false,
  109.                 "enrolled": "Y",
  110.                 "authentication_response": "Y",
  111.                 "cryptogram": "AAABAVIREQAAAAAAAAAAAAAAAAA=",
  112.                 "xid": "4f422d6d-3cb5-4efc-ae20-48b43216af81",
  113.                 "version": "2.1.0",
  114.                 "challenged": true
  115.             },
  116.             "balances": {
  117.                 "total_authorized": 1005,
  118.                 "total_voided": 0,
  119.                 "available_to_void": 0,
  120.                 "total_captured": 1005,
  121.                 "available_to_capture": 0,
  122.                 "total_refunded": 0,
  123.                 "available_to_refund": 1005
  124.             },
  125.             "risk": {
  126.                 "flagged": false
  127.             },
  128.             "customer": {
  129.                 "id": "cus_57x7gb4wtxquxn3gqye2hujnt4",
  130.                 "email": "123@test.com",
  131.                 "name": "1234567"
  132.             },
  133.             "billing_descriptor": {
  134.                 "name": "SUPERHEROES.COM",
  135.                 "city": "GOTHAM"
  136.             },
  137.             "shipping": {
  138.                 "address": {
  139.                     "address_line1": "Checkout.com",
  140.                     "address_line2": "90 Tottenham Court Road",
  141.                     "city": "London",
  142.                     "state": "London",
  143.                     "zip": "W1T 4TJ",
  144.                     "country": "GB"
  145.                 },
  146.                 "phone": {
  147.                     "country_code": "+1",
  148.                     "number": "415 555 2671"
  149.                 }
  150.             },
  151.             "payment_ip": "111.111.111.1",
  152.             "metadata": {
  153.                 "coupon_code": "NY2018",
  154.                 "partner_id": "123989",
  155.                 "udf1": "1234567"
  156.             },
  157.             "eci": "05",
  158.             "scheme_id": "547583399099070",
  159.             "_links": {
  160.                 "self": {
  161.                     "href": "https://api.sandbox.checkout.com/payments/pay_ychk42fsoeqefeqbz65ocr55gy"
  162.                 },
  163.                 "actions": {
  164.                     "href": "https://api.sandbox.checkout.com/payments/pay_ychk42fsoeqefeqbz65ocr55gy/actions"
  165.                 },
  166.                 "refund": {
  167.                     "href": "https://api.sandbox.checkout.com/payments/pay_ychk42fsoeqefeqbz65ocr55gy/refunds"
  168.                 }
  169.             }
  170.         },
  171.         {
  172.             "id": "pay_kx4obw2lptbuvhzrdzlv3lp6ti",
  173.             "requested_on": "2022-06-23T06:49:49.1610796Z",
  174.             "source": {
  175.                 "id": "src_mi2hv7zzpjfebjjnrsj2rhtmjy",
  176.                 "type": "card",
  177.                 "expiry_month": 12,
  178.                 "expiry_year": 2025,
  179.                 "scheme": "Mastercard",
  180.                 "last4": "9682",
  181.                 "fingerprint": "CC08517F2B99EEA15A87891C1B5E74867E793AD6C4116422F049996EF80BADE6",
  182.                 "bin": "543782",
  183.                 "card_type": "CREDIT",
  184.                 "card_category": "CONSUMER",
  185.                 "issuer": "TAISHIN INTERNATIONAL BANK",
  186.                 "issuer_country": "TW",
  187.                 "product_id": "MCS",
  188.                 "product_type": "Standard MasterCard® Card",
  189.                 "avs_check": "S",
  190.                 "payment_account_reference": ""
  191.             },
  192.             "amount": 1005,
  193.             "currency": "USD",
  194.             "payment_type": "Regular",
  195.             "reference": "ORD-Test-2022-23",
  196.             "description": "Set of 3 masks",
  197.             "status": "Declined",
  198.             "approved": false,
  199.             "3ds": {
  200.                 "downgraded": false,
  201.                 "enrolled": "Y",
  202.                 "version": "2.1.0",
  203.                 "challenged": false
  204.             },
  205.             "risk": {
  206.                 "flagged": false
  207.             },
  208.             "customer": {
  209.                 "id": "cus_57x7gb4wtxquxn3gqye2hujnt4",
  210.                 "email": "123@test.com",
  211.                 "name": "1234567"
  212.             },
  213.             "billing_descriptor": {
  214.                 "name": "SUPERHEROES.COM",
  215.                 "city": "GOTHAM"
  216.             },
  217.             "shipping": {
  218.                 "address": {
  219.                     "address_line1": "Checkout.com",
  220.                     "address_line2": "90 Tottenham Court Road",
  221.                     "city": "London",
  222.                     "state": "London",
  223.                     "zip": "W1T 4TJ",
  224.                     "country": "GB"
  225.                 },
  226.                 "phone": {
  227.                     "country_code": "+1",
  228.                     "number": "415 555 2671"
  229.                 }
  230.             },
  231.             "payment_ip": "111.111.111.1",
  232.             "metadata": {
  233.                 "coupon_code": "NY2018",
  234.                 "partner_id": "123989",
  235.                 "udf1": "1234567"
  236.             },
  237.             "_links": {
  238.                 "self": {
  239.                     "href": "https://api.sandbox.checkout.com/payments/pay_kx4obw2lptbuvhzrdzlv3lp6ti"
  240.                 },
  241.                 "actions": {
  242.                     "href": "https://api.sandbox.checkout.com/payments/pay_kx4obw2lptbuvhzrdzlv3lp6ti/actions"
  243.                 }
  244.             }
  245.         },
  246.         {
  247.             "id": "pay_fldc2qja2rsezn3o4tfakdwzgq",
  248.             "requested_on": "2022-06-23T06:33:40.62936Z",
  249.             "source": {
  250.                 "type": "card",
  251.                 "expiry_month": 12,
  252.                 "expiry_year": 2025,
  253.                 "scheme": "Mastercard",
  254.                 "last4": "9682",
  255.                 "fingerprint": "CC08517F2B99EEA15A87891C1B5E74867E793AD6C4116422F049996EF80BADE6",
  256.                 "bin": "543782",
  257.                 "card_type": "CREDIT",
  258.                 "card_category": "CONSUMER",
  259.                 "issuer": "TAISHIN INTERNATIONAL BANK",
  260.                 "issuer_country": "TW",
  261.                 "product_id": "MCS"
  262.             },
  263.             "amount": 1005,
  264.             "currency": "USD",
  265.             "payment_type": "Regular",
  266.             "reference": "ORD-Test-2022-23",
  267.             "description": "Set of 3 masks",
  268.             "status": "Pending",
  269.             "3ds": {
  270.                 "downgraded": false,
  271.                 "enrolled": "Y",
  272.                 "version": "2.1.0"
  273.             },
  274.             "risk": {
  275.                 "flagged": false
  276.             },
  277.             "customer": {
  278.                 "id": "cus_57x7gb4wtxquxn3gqye2hujnt4",
  279.                 "email": "123@test.com",
  280.                 "name": "1234567"
  281.             },
  282.             "billing_descriptor": {
  283.                 "name": "SUPERHEROES.COM",
  284.                 "city": "GOTHAM"
  285.             },
  286.             "shipping": {
  287.                 "address": {
  288.                     "address_line1": "Checkout.com",
  289.                     "address_line2": "90 Tottenham Court Road",
  290.                     "city": "London",
  291.                     "state": "London",
  292.                     "zip": "W1T 4TJ",
  293.                     "country": "GB"
  294.                 },
  295.                 "phone": {
  296.                     "country_code": "+1",
  297.                     "number": "415 555 2671"
  298.                 }
  299.             },
  300.             "payment_ip": "111.111.111.1",
  301.             "metadata": {
  302.                 "coupon_code": "NY2018",
  303.                 "partner_id": "123989",
  304.                 "udf1": "1234567"
  305.             },
  306.             "_links": {
  307.                 "self": {
  308.                     "href": "https://api.sandbox.checkout.com/payments/pay_fldc2qja2rsezn3o4tfakdwzgq"
  309.                 },
  310.                 "actions": {
  311.                     "href": "https://api.sandbox.checkout.com/payments/pay_fldc2qja2rsezn3o4tfakdwzgq/actions"
  312.                 }
  313.             }
  314.         },
  315.         {
  316.             "id": "pay_hk5nzpfzbkaunezs6vl54migri",
  317.             "requested_on": "2022-06-23T06:48:09.9967319Z",
  318.             "source": {
  319.                 "id": "src_mi2hv7zzpjfebjjnrsj2rhtmjy",
  320.                 "type": "card",
  321.                 "expiry_month": 12,
  322.                 "expiry_year": 2025,
  323.                 "scheme": "Mastercard",
  324.                 "last4": "9682",
  325.                 "fingerprint": "CC08517F2B99EEA15A87891C1B5E74867E793AD6C4116422F049996EF80BADE6",
  326.                 "bin": "543782",
  327.                 "card_type": "CREDIT",
  328.                 "card_category": "CONSUMER",
  329.                 "issuer": "TAISHIN INTERNATIONAL BANK",
  330.                 "issuer_country": "TW",
  331.                 "product_id": "MCS",
  332.                 "product_type": "Standard MasterCard® Card",
  333.                 "avs_check": "S",
  334.                 "payment_account_reference": ""
  335.             },
  336.             "amount": 1005,
  337.             "currency": "USD",
  338.             "payment_type": "Regular",
  339.             "reference": "ORD-Test-2022-23",
  340.             "description": "Set of 3 masks",
  341.             "status": "Declined",
  342.             "approved": false,
  343.             "3ds": {
  344.                 "downgraded": false,
  345.                 "enrolled": "Y",
  346.                 "version": "2.1.0",
  347.                 "challenged": false
  348.             },
  349.             "risk": {
  350.                 "flagged": false
  351.             },
  352.             "customer": {
  353.                 "id": "cus_57x7gb4wtxquxn3gqye2hujnt4",
  354.                 "email": "123@test.com",
  355.                 "name": "1234567"
  356.             },
  357.             "billing_descriptor": {
  358.                 "name": "SUPERHEROES.COM",
  359.                 "city": "GOTHAM"
  360.             },
  361.             "shipping": {
  362.                 "address": {
  363.                     "address_line1": "Checkout.com",
  364.                     "address_line2": "90 Tottenham Court Road",
  365.                     "city": "London",
  366.                     "state": "London",
  367.                     "zip": "W1T 4TJ",
  368.                     "country": "GB"
  369.                 },
  370.                 "phone": {
  371.                     "country_code": "+1",
  372.                     "number": "415 555 2671"
  373.                 }
  374.             },
  375.             "payment_ip": "111.111.111.1",
  376.             "metadata": {
  377.                 "coupon_code": "NY2018",
  378.                 "partner_id": "123989",
  379.                 "udf1": "1234567"
  380.             },
  381.             "_links": {
  382.                 "self": {
  383.                     "href": "https://api.sandbox.checkout.com/payments/pay_hk5nzpfzbkaunezs6vl54migri"
  384.                 },
  385.                 "actions": {
  386.                     "href": "https://api.sandbox.checkout.com/payments/pay_hk5nzpfzbkaunezs6vl54migri/actions"
  387.                 }
  388.             }
  389.         },
  390.         {
  391.             "id": "pay_kpproj7wylwexb7tnz6rvbf6za",
  392.             "requested_on": "2022-06-23T06:46:38.5503044Z",
  393.             "source": {
  394.                 "type": "card",
  395.                 "expiry_month": 12,
  396.                 "expiry_year": 2025,
  397.                 "scheme": "Visa",
  398.                 "last4": "9271",
  399.                 "fingerprint": "C7554274164DC90AD78DBDBCDB764AE61947422B724698D709176FCF41957C30",
  400.                 "bin": "427576",
  401.                 "card_type": "CREDIT",
  402.                 "issuer": "OCEANFIRST BANK N.A.",
  403.                 "issuer_country": "US"
  404.             },
  405.             "amount": 1005,
  406.             "currency": "USD",
  407.             "payment_type": "Regular",
  408.             "reference": "ORD-Test-2022-23",
  409.             "description": "Set of 3 masks",
  410.             "status": "Declined",
  411.             "approved": false,
  412.             "3ds": {
  413.                 "downgraded": false,
  414.                 "enrolled": "Y",
  415.                 "authentication_response": "N",
  416.                 "version": "2.1.0",
  417.                 "challenged": false
  418.             },
  419.             "risk": {
  420.                 "flagged": false
  421.             },
  422.             "customer": {
  423.                 "id": "cus_57x7gb4wtxquxn3gqye2hujnt4",
  424.                 "email": "123@test.com",
  425.                 "name": "1234567"
  426.             },
  427.             "billing_descriptor": {
  428.                 "name": "SUPERHEROES.COM",
  429.                 "city": "GOTHAM"
  430.             },
  431.             "shipping": {
  432.                 "address": {
  433.                     "address_line1": "Checkout.com",
  434.                     "address_line2": "90 Tottenham Court Road",
  435.                     "city": "London",
  436.                     "state": "London",
  437.                     "zip": "W1T 4TJ",
  438.                     "country": "GB"
  439.                 },
  440.                 "phone": {
  441.                     "country_code": "+1",
  442.                     "number": "415 555 2671"
  443.                 }
  444.             },
  445.             "payment_ip": "111.111.111.1",
  446.             "metadata": {
  447.                 "coupon_code": "NY2018",
  448.                 "partner_id": "123989",
  449.                 "udf1": "1234567"
  450.             },
  451.             "_links": {
  452.                 "self": {
  453.                     "href": "https://api.sandbox.checkout.com/payments/pay_kpproj7wylwexb7tnz6rvbf6za"
  454.                 },
  455.                 "actions": {
  456.                     "href": "https://api.sandbox.checkout.com/payments/pay_kpproj7wylwexb7tnz6rvbf6za/actions"
  457.                 }
  458.             }
  459.         },
  460.         {
  461.             "id": "pay_lecutghc3bku7fphy4yfvzgxfq",
  462.             "requested_on": "2022-06-23T06:26:17.843292Z",
  463.             "source": {
  464.                 "type": "card",
  465.                 "expiry_month": 12,
  466.                 "expiry_year": 2025,
  467.                 "scheme": "Visa",
  468.                 "last4": "4242",
  469.                 "fingerprint": "71580B426F1D190D29087FF265D8F48DF1AD34EDE41C27CBFF9D23C1A14D1776",
  470.                 "bin": "424242",
  471.                 "card_type": "CREDIT",
  472.                 "card_category": "CONSUMER",
  473.                 "issuer_country": "GB",
  474.                 "product_id": "F"
  475.             },
  476.             "amount": 1000,
  477.             "currency": "USD",
  478.             "payment_type": "Regular",
  479.             "reference": "ORD-Test-2022-23",
  480.             "description": "Set of 3 masks",
  481.             "status": "Pending",
  482.             "3ds": {
  483.                 "downgraded": false,
  484.                 "enrolled": "Y",
  485.                 "version": "2.1.0"
  486.             },
  487.             "risk": {
  488.                 "flagged": false
  489.             },
  490.             "customer": {
  491.                 "id": "cus_57x7gb4wtxquxn3gqye2hujnt4",
  492.                 "email": "123@test.com",
  493.                 "name": "1234567"
  494.             },
  495.             "billing_descriptor": {
  496.                 "name": "SUPERHEROES.COM",
  497.                 "city": "GOTHAM"
  498.             },
  499.             "shipping": {
  500.                 "address": {
  501.                     "address_line1": "Checkout.com",
  502.                     "address_line2": "90 Tottenham Court Road",
  503.                     "city": "London",
  504.                     "state": "London",
  505.                     "zip": "W1T 4TJ",
  506.                     "country": "GB"
  507.                 },
  508.                 "phone": {
  509.                     "country_code": "+1",
  510.                     "number": "415 555 2671"
  511.                 }
  512.             },
  513.             "payment_ip": "111.111.111.1",
  514.             "metadata": {
  515.                 "coupon_code": "NY2018",
  516.                 "partner_id": "123989",
  517.                 "udf1": "1234567"
  518.             },
  519.             "_links": {
  520.                 "self": {
  521.                     "href": "https://api.sandbox.checkout.com/payments/pay_lecutghc3bku7fphy4yfvzgxfq"
  522.                 },
  523.                 "actions": {
  524.                     "href": "https://api.sandbox.checkout.com/payments/pay_lecutghc3bku7fphy4yfvzgxfq/actions"
  525.                 }
  526.             }
  527.         },
  528.         {
  529.             "id": "pay_3qo4r3vdlrqulm2xlfsbthvevy",
  530.             "requested_on": "2022-06-23T06:34:08.7072384Z",
  531.             "source": {
  532.                 "type": "card",
  533.                 "expiry_month": 12,
  534.                 "expiry_year": 2025,
  535.                 "scheme": "Visa",
  536.                 "last4": "9271",
  537.                 "fingerprint": "C7554274164DC90AD78DBDBCDB764AE61947422B724698D709176FCF41957C30",
  538.                 "bin": "427576",
  539.                 "card_type": "CREDIT",
  540.                 "issuer": "OCEANFIRST BANK N.A.",
  541.                 "issuer_country": "US"
  542.             },
  543.             "amount": 1005,
  544.             "currency": "USD",
  545.             "payment_type": "Regular",
  546.             "reference": "ORD-Test-2022-23",
  547.             "description": "Set of 3 masks",
  548.             "status": "Declined",
  549.             "approved": false,
  550.             "3ds": {
  551.                 "downgraded": false,
  552.                 "enrolled": "Y",
  553.                 "authentication_response": "N",
  554.                 "version": "2.1.0",
  555.                 "challenged": false
  556.             },
  557.             "risk": {
  558.                 "flagged": false
  559.             },
  560.             "customer": {
  561.                 "id": "cus_57x7gb4wtxquxn3gqye2hujnt4",
  562.                 "email": "123@test.com",
  563.                 "name": "1234567"
  564.             },
  565.             "billing_descriptor": {
  566.                 "name": "SUPERHEROES.COM",
  567.                 "city": "GOTHAM"
  568.             },
  569.             "shipping": {
  570.                 "address": {
  571.                     "address_line1": "Checkout.com",
  572.                     "address_line2": "90 Tottenham Court Road",
  573.                     "city": "London",
  574.                     "state": "London",
  575.                     "zip": "W1T 4TJ",
  576.                     "country": "GB"
  577.                 },
  578.                 "phone": {
  579.                     "country_code": "+1",
  580.                     "number": "415 555 2671"
  581.                 }
  582.             },
  583.             "payment_ip": "111.111.111.1",
  584.             "metadata": {
  585.                 "coupon_code": "NY2018",
  586.                 "partner_id": "123989",
  587.                 "udf1": "1234567"
  588.             },
  589.             "_links": {
  590.                 "self": {
  591.                     "href": "https://api.sandbox.checkout.com/payments/pay_3qo4r3vdlrqulm2xlfsbthvevy"
  592.                 },
  593.                 "actions": {
  594.                     "href": "https://api.sandbox.checkout.com/payments/pay_3qo4r3vdlrqulm2xlfsbthvevy/actions"
  595.                 }
  596.             }
  597.         },
  598.         {
  599.             "id": "pay_2zwn4vfrl2fe3f6vberu5hqz74",
  600.             "requested_on": "2022-06-23T06:29:55.5802922Z",
  601.             "source": {
  602.                 "id": "src_mi2hv7zzpjfebjjnrsj2rhtmjy",
  603.                 "type": "card",
  604.                 "expiry_month": 12,
  605.                 "expiry_year": 2025,
  606.                 "scheme": "Mastercard",
  607.                 "last4": "9682",
  608.                 "fingerprint": "CC08517F2B99EEA15A87891C1B5E74867E793AD6C4116422F049996EF80BADE6",
  609.                 "bin": "543782",
  610.                 "card_type": "CREDIT",
  611.                 "card_category": "CONSUMER",
  612.                 "issuer": "TAISHIN INTERNATIONAL BANK",
  613.                 "issuer_country": "TW",
  614.                 "product_id": "MCS",
  615.                 "product_type": "Standard MasterCard® Card",
  616.                 "avs_check": "S",
  617.                 "payment_account_reference": ""
  618.             },
  619.             "amount": 1005,
  620.             "currency": "USD",
  621.             "payment_type": "Regular",
  622.             "reference": "ORD-Test-2022-23",
  623.             "description": "Set of 3 masks",
  624.             "status": "Declined",
  625.             "approved": false,
  626.             "3ds": {
  627.                 "downgraded": false,
  628.                 "enrolled": "Y",
  629.                 "version": "2.1.0",
  630.                 "challenged": false
  631.             },
  632.             "risk": {
  633.                 "flagged": false
  634.             },
  635.             "customer": {
  636.                 "id": "cus_57x7gb4wtxquxn3gqye2hujnt4",
  637.                 "email": "123@test.com",
  638.                 "name": "1234567"
  639.             },
  640.             "billing_descriptor": {
  641.                 "name": "SUPERHEROES.COM",
  642.                 "city": "GOTHAM"
  643.             },
  644.             "shipping": {
  645.                 "address": {
  646.                     "address_line1": "Checkout.com",
  647.                     "address_line2": "90 Tottenham Court Road",
  648.                     "city": "London",
  649.                     "state": "London",
  650.                     "zip": "W1T 4TJ",
  651.                     "country": "GB"
  652.                 },
  653.                 "phone": {
  654.                     "country_code": "+1",
  655.                     "number": "415 555 2671"
  656.                 }
  657.             },
  658.             "payment_ip": "111.111.111.1",
  659.             "metadata": {
  660.                 "coupon_code": "NY2018",
  661.                 "partner_id": "123989",
  662.                 "udf1": "1234567"
  663.             },
  664.             "_links": {
  665.                 "self": {
  666.                     "href": "https://api.sandbox.checkout.com/payments/pay_2zwn4vfrl2fe3f6vberu5hqz74"
  667.                 },
  668.                 "actions": {
  669.                     "href": "https://api.sandbox.checkout.com/payments/pay_2zwn4vfrl2fe3f6vberu5hqz74/actions"
  670.                 }
  671.             }
  672.         },
  673.         {
  674.             "id": "pay_k3ztmuseu44uzo3ceced6btaay",
  675.             "requested_on": "2022-06-23T06:28:54.6638826Z",
  676.             "source": {
  677.                 "id": "src_33yoxu6f6fdujclo33v43oyf6q",
  678.                 "type": "card",
  679.                 "expiry_month": 12,
  680.                 "expiry_year": 2025,
  681.                 "scheme": "Visa",
  682.                 "last4": "4242",
  683.                 "fingerprint": "71580B426F1D190D29087FF265D8F48DF1AD34EDE41C27CBFF9D23C1A14D1776",
  684.                 "bin": "424242",
  685.                 "card_type": "CREDIT",
  686.                 "card_category": "CONSUMER",
  687.                 "issuer_country": "GB",
  688.                 "product_id": "F",
  689.                 "product_type": "Visa Classic",
  690.                 "avs_check": "G",
  691.                 "payment_account_reference": "V001953367319328872"
  692.             },
  693.             "expires_on": "2022-07-23T06:29:04.3750285Z",
  694.             "amount": 1005,
  695.             "currency": "USD",
  696.             "payment_type": "Regular",
  697.             "reference": "ORD-Test-2022-23",
  698.             "description": "Set of 3 masks",
  699.             "status": "Captured",
  700.             "approved": true,
  701.             "3ds": {
  702.                 "downgraded": false,
  703.                 "enrolled": "Y",
  704.                 "authentication_response": "Y",
  705.                 "cryptogram": "AAABAVIREQAAAAAAAAAAAAAAAAA=",
  706.                 "xid": "778324c3-e770-470b-95b6-f3054dca2499",
  707.                 "version": "2.1.0",
  708.                 "challenged": true
  709.             },
  710.             "balances": {
  711.                 "total_authorized": 1005,
  712.                 "total_voided": 0,
  713.                 "available_to_void": 0,
  714.                 "total_captured": 1005,
  715.                 "available_to_capture": 0,
  716.                 "total_refunded": 0,
  717.                 "available_to_refund": 1005
  718.             },
  719.             "risk": {
  720.                 "flagged": false
  721.             },
  722.             "customer": {
  723.                 "id": "cus_57x7gb4wtxquxn3gqye2hujnt4",
  724.                 "email": "123@test.com",
  725.                 "name": "1234567"
  726.             },
  727.             "billing_descriptor": {
  728.                 "name": "SUPERHEROES.COM",
  729.                 "city": "GOTHAM"
  730.             },
  731.             "shipping": {
  732.                 "address": {
  733.                     "address_line1": "Checkout.com",
  734.                     "address_line2": "90 Tottenham Court Road",
  735.                     "city": "London",
  736.                     "state": "London",
  737.                     "zip": "W1T 4TJ",
  738.                     "country": "GB"
  739.                 },
  740.                 "phone": {
  741.                     "country_code": "+1",
  742.                     "number": "415 555 2671"
  743.                 }
  744.             },
  745.             "payment_ip": "111.111.111.1",
  746.             "metadata": {
  747.                 "coupon_code": "NY2018",
  748.                 "partner_id": "123989",
  749.                 "udf1": "1234567"
  750.             },
  751.             "eci": "05",
  752.             "scheme_id": "910226692214436",
  753.             "_links": {
  754.                 "self": {
  755.                     "href": "https://api.sandbox.checkout.com/payments/pay_k3ztmuseu44uzo3ceced6btaay"
  756.                 },
  757.                 "actions": {
  758.                     "href": "https://api.sandbox.checkout.com/payments/pay_k3ztmuseu44uzo3ceced6btaay/actions"
  759.                 },
  760.                 "refund": {
  761.                     "href": "https://api.sandbox.checkout.com/payments/pay_k3ztmuseu44uzo3ceced6btaay/refunds"
  762.                 }
  763.             }
  764.         }
  765.     ]
  766. }

如何获取pay｜sid_id

pay id是Checkout.com对于一笔支付请求全生命周期的唯一id，如后续发生了退款，拒付等，都可以使用pay id进行关联。
sid id是使用了Checkout.com 3DS服务后返回的session id，也可以用支付状态的查询。

1. HPP - 在重定向URL中

当用户在Hosted Payment Page完成支付并返回商户后，会在URL中添加pay id参数。当发起的支付为非3DS时参数名为cko-payment-id，发起的支付为3DS时参数名为cko-session-id：
如：

  1. http://127.0.0.1:3000/result?cko-payment-id=pay_nixj7hl4mqa2voubnsgqnyj4vy
  1. http://127.0.0.1:3000/result?cko-session-id=sid_eiac54qsba5u7mc345t3z3cg5e

2. iFrame - 在Payment同步返回中获取

当一笔支付请求通过后端API发起后，Checkout.com的返回报文中会包含这笔支付对应的pay id，对于3DS和非3DS场景都适用。如：

  1. {
  2.     "id": "pay_o7celawubynk3bxb3zcvyphi34",
  3.     "action_id": "act_o7celawubynk3bxb3zcvyphi34",
  4.     "amount": 100,
  5.     "currency": "EUR",
  6.     "approved": true,
  7.     "status": "Authorized",
  8.     "auth_code": "644416",
  9.     "scheme_id": "573899136006756",
  10.     "response_code": "10000",
  11.     "response_summary": "Approved",
  12.     "risk": {
  13.         "flagged": false
  14.     },
  15.     "source": {
  16.         "id": "src_pztzr25mrs6ehbmydsf3gl7lmm",
  17.         "type": "card",
  18.         "billing_address": {
  19.             "address_line1": "Checkout.com",
  20.             "address_line2": "90 Tottenham Court Road",
  21.             "city": "London",
  22.             "state": "London",
  23.             "zip": "W1T 4TJ",
  24.             "country": "GB"
  25.         },
  26.         "phone": {
  27.             "country_code": "1",
  28.             "number": "415 555 2671"
  29.         },
  30.         "expiry_month": 2,
  31.         "expiry_year": 2023,
  32.         "name": "eliz11",
  33.         "last4": "5580",
  34.         "fingerprint": "4CEB14B6CB325EFEA1394B1ECCAAFF4A19877A5D782548C95EC3B500D487404C",
  35.         "bin": "455657",
  36.         "avs_check": "S",
  37.         "cvv_check": "Y"
  38.     },
  39.     "customer": {
  40.         "id": "cus_jdfhuetl57pelcl5cj5agl3tne",
  41.         "name": "eliz11"
  42.     },
  43.     "processed_on": "2022-04-24T03:43:52Z",
  44.     "reference": "PAYIN-TOPUP",
  45.     "processing": {
  46.         "acquirer_transaction_id": "5625123245",
  47.         "retrieval_reference_number": "761892595599"
  48.     },
  49.     "_links": {
  50.         "self": {
  51.             "href": "https://api.sandbox.checkout.com/payments/pay_o7celawubynk3bxb3zcvyphi34"
  52.         },
  53.         "actions": {
  54.             "href": "https://api.sandbox.checkout.com/payments/pay_o7celawubynk3bxb3zcvyphi34/actions"
  55.         },
  56.         "capture": {
  57.             "href": "https://api.sandbox.checkout.com/payments/pay_o7celawubynk3bxb3zcvyphi34/captures"
  58.         },
  59.         "void": {
  60.             "href": "https://api.sandbox.checkout.com/payments/pay_o7celawubynk3bxb3zcvyphi34/voids"
  61.         }
  62.     }
  63. }
  1. {
  2.     "id": "pay_ktvg6sa6bpq2lbjh4rlbomywta",
  3.     "status": "Pending",
  4.     "reference": "PAYIN-TOPUP",
  5.     "customer": {
  6.         "id": "cus_ix6rhmhqxyuude22dg2odmy6iy",
  7.         "name": "eliz11"
  8.     },
  9.     "3ds": {
  10.         "downgraded": false,
  11.         "enrolled": "Y"
  12.     },
  13.     "_links": {
  14.         "self": {
  15.             "href": "https://api.sandbox.checkout.com/payments/pay_ktvg6sa6bpq2lbjh4rlbomywta"
  16.         },
  17.         "redirect": {
  18.             "href": "https://3ds2-sandbox.ckotech.co/interceptor/3ds_ms5rgq3gaqoejdehwibrzpeenu"
  19.         }
  20.     }
  21. }

3. iFrame - 在重定向URL中

当用户使用3DS进行支付时，支付完成后会与Hosted Payment Page类似重定向到商户定义的URL，并添加pay id参数，参数名为cko-session-id。如：

  1. http://127.0.0.1:3000/result?cko-session-id=sid_ppk3w4f365delghy6zhb7h2rju

4. HPP&iFrame - 在Webhook中获取

对于HPP或者iFrame都可以通过Webhook获取pay id。
如类型payment_approved/payment_decline的Webhook，以下为示例：

  1. {
  2.   "id": "evt_vha2gih6tl5u5ebrpajhm727fe",
  3.   "type": "payment_approved",
  4.   "created_on": "2019-06-07T08:25:21Z",
  5.   "data": {
  6.     "action_id": "act_waji5li3mqtetnaor77xmow4bq",
  7.     "payment_type": "REGULAR",
  8.     "auth_code": "007895",
  9.     "response_code": "10000",
  10.     "response_summary": "Approved",
  11.     "scheme_id": "638284745624527",
  12.     "source": {
  13.       "id": "src_isu5yyegxg4e5l5yadnpu6y744",
  14.       "type": "card",
  15.       "billing_address": {},
  16.       "expiry_month": 12,
  17.       "expiry_year": 2025,
  18.       "scheme": "VISA",
  19.       "last_4": "4242",
  20.       "fingerprint": "71580b426f1d190d29087ff265d8f48df1ad34ede41c27cbff9d23c1a14d1776",
  21.       "bin": "424242",
  22.       "card_type": "Credit",
  23.       "card_category": "Consumer",
  24.       "issuer": "JPMORGAN CHASE BANK NA",
  25.       "issuer_country": "US",
  26.       "product_id": "A",
  27.       "product_type": "Visa Traditional",
  28.       "avs_check": "S",
  29.       "cvv_check": ""
  30.     },
  31.     "customer": {
  32.       "id": "cus_gs47qn23bqmefhkmlpokm7vzxm"
  33.     },
  34.     "processing": {
  35.       "acquirer_transaction_id": "8137549556",
  36.       "retrieval_reference_number": "000007895269"
  37.     },
  38.     "amount": 10000,
  39.     "metadata": {},
  40.     "risk": {
  41.       "flagged": false
  42.     },
  43.     "id": "pay_waji5li3mqtetnaor77xmow4bq",
  44.     "currency": "EUR",
  45.     "processed_on": "2019-06-07T08:25:21Z",
  46.     "reference": "ORD-5023-4E89"
  47.     },
  48.   "_links": {
  49.     "self": {
  50.       "href": "https://api.sandbox.checkout.com/events/evt_vha2gih6tl5u5ebrpajhm727fe"
  51.     },
  52.     "payment": {
  53.       "href": "https://api.sandbox.checkout.com/payments/pay_waji5li3mqtetnaor77xmow4bq"
  54.     }
  55.   }
  56. }
  1. {
  2.   "id": "evt_h3wfa5symn3ehof6fbgilpu5fm",
  3.   "type": "payment_declined",
  4.   "created_on": "2019-06-07T08:27:26Z",
  5.   "data": {
  6.     "action_id": "act_pfyq4sdkrvoexn737g2e26c3xm",
  7.     "payment_type": "REGULAR",
  8.     "auth_code": "000000",
  9.     "response_code": "20005",
  10.     "response_summary": "Declined - Do Not Honour",
  11.     "scheme_id": "638284745624527",
  12.     "amount": 5,
  13.     "source": {
  14.       "id": "src_isu5yyegxg4e5l5yadnpu6y744",
  15.       "type": "card",
  16.       "expiry_month": 12,
  17.       "expiry_year": 2025,
  18.       "scheme": "VISA",
  19.       "last_4": "4242",
  20.       "fingerprint": "71580b426f1d190d29087ff265d8f48df1ad34ede41c27cbff9d23c1a14d1776",
  21.       "bin": "424242",
  22.       "card_type": "Credit",
  23.       "card_category": "Consumer",
  24.       "issuer": "JPMORGAN CHASE BANK NA",
  25.       "issuer_country": "US",
  26.       "product_id": "A",
  27.       "product_type": "Visa Traditional",
  28.       "avs_check": "S",
  29.       "cvv_check": ""
  30.     },
  31.     "customer": {
  32.       "id": "cus_gs47qn23bqmefhkmlpokm7vzxm"
  33.     },
  34.     "processing": {
  35.       "acquirer_transaction_id": "8137549596",
  36.       "retrieval_reference_number": "000896481776"
  37.     },
  38.     "id": "pay_pfyq4sdkrvoexn737g2e26c3xm",
  39.     "currency": "EUR",
  40.     "processed_on": "2019-06-07T08:27:26Z",
  41.     "reference": "ORD-5023-4E89"
  42.   },
  43.   "_links": {
  44.     "self": {
  45.       "href": "https://api.sandbox.checkout.com/events/evt_h3wfa5symn3ehof6fbgilpu5fm"
  46.     },
  47.     "payment": {
  48.       "href": "https://api.sandbox.checkout.com/payments/pay_pfyq4sdkrvoexn737g2e26c3xm"
  49.     }
  50.   }
  51. }

如何判断支付结果

不同支付方式会对应不同的支付状态，以下主要针对卡支付进行说明。

在查询结果中，主要通过两个参数来进行结果的判断

status：表示当前交易的状态
approved：表示授权或请款是否成功

主要状态判断逻辑如下：

approved status 支付结果
true Authorized 授权成功，待请款（扣款）
true Card Verified 验卡成功
true Partially Captured 部分请款成功（部分扣款成功）
true Captured 全额请款成功（全额扣款成功）
false Declined 支付失败
true Partially Refunded 部分退款成功
true Refunded 全额退款成功
true Voided 授权已撤销
空 Pending 等待3DS验证结果

其中最重要的是 approved = true 且 status = Captured，表示请款成功（扣款成功）。

使用sid_id查询

在3DS支付场景下，若使用sid_id进行查询时，根据3DS验证的状态可能出现以下几类返回：

  1. 若3DS验证尚未完成

status = Pending，不返回action_id这一object

  1. {
  2.     "id": "pay_blm2tkmqurwere5rkd6x7cvdxu",
  3.     "requested_on": "2022-06-29T08:50:04.2902423Z",
  4.     "source": {
  5.         "type": "card",
  6.         "billing_address": {
  7.             "country": "HK"
  8.         },
  9.         "expiry_month": 2,
  10.         "expiry_year": 2023,
  11.         "scheme": "Visa",
  12.         "last4": "4242",
  13.         "fingerprint": "67CF46597CE027875ED8230F168703A1D49E8D10622180AE58BB08813B3233D3",
  14.         "bin": "424242",
  15.         "card_type": "CREDIT",
  16.         "card_category": "CONSUMER",
  17.         "issuer_country": "GB",
  18.         "product_id": "F"
  19.     },
  20.     "amount": 100010,
  21.     "currency": "USD",
  22.     "payment_type": "Regular",
  23.     "reference": "PAYIN-TOPUP",
  24.     "description": "Set of 3 masks",
  25.     "status": "Pending",
  26.     "3ds": {
  27.         "downgraded": false,
  28.         "enrolled": "Y",
  29.         "version": "2.1.0"
  30.     },
  31.     "risk": {
  32.         "flagged": false
  33.     },
  34.     "customer": {
  35.         "id": "cus_s6ba5uw54r7uhcstltrubhrcaq",
  36.         "email": "abc@163.com"
  37.     },
  38.     "billing_descriptor": {
  39.         "name": "test_merchant",
  40.         "city": " "
  41.     },
  42.     "shipping": {
  43.         "address": {
  44.             "address_line1": "Checkout.com",
  45.             "address_line2": "90 Tottenham Court Road",
  46.             "city": "London",
  47.             "state": "London",
  48.             "zip": "W1T 4TJ",
  49.             "country": "HK"
  50.         },
  51.         "phone": {
  52.             "country_code": "+1",
  53.             "number": "415 555 2671"
  54.         }
  55.     },
  56.     "_links": {
  57.         "self": {
  58.             "href": "https://api.sandbox.checkout.com/payments/pay_blm2tkmqurwere5rkd6x7cvdxu"
  59.         },
  60.         "actions": {
  61.             "href": "https://api.sandbox.checkout.com/payments/pay_blm2tkmqurwere5rkd6x7cvdxu/actions"
  62.         },
  63.         "redirect": {
  64.             "href": "https://api.sandbox.checkout.com/sessions-interceptor/sid_dszjr3brue6epfvlvyq4lv6okm"
  65.         }
  66.     }
  67. }
  1. 若3DS验证失败

status = Declined，不返回action_id这一object

  1. {
  2.     "id": "pay_iag2yexmxktkjpvvk4rdp2qvwi",
  3.     "requested_on": "2022-06-29T09:00:49Z",
  4.     "source": {
  5.         "type": "card",
  6.         "billing_address": {
  7.             "country": "HK"
  8.         },
  9.         "expiry_month": 2,
  10.         "expiry_year": 2023,
  11.         "scheme": "Visa",
  12.         "last4": "4242",
  13.         "fingerprint": "67CF46597CE027875ED8230F168703A1D49E8D10622180AE58BB08813B3233D3",
  14.         "bin": "424242",
  15.         "card_type": "Credit",
  16.         "card_category": "Consumer",
  17.         "issuer": "JPMORGAN CHASE BANK NA",
  18.         "issuer_country": "US",
  19.         "product_id": "A",
  20.         "product_type": "Visa Traditional"
  21.     },
  22.     "amount": 300,
  23.     "currency": "USD",
  24.     "payment_type": "Regular",
  25.     "reference": "PAYIN-TOPUP",
  26.     "description": "Set of 3 masks",
  27.     "status": "Declined",
  28.     "approved": false,
  29.     "3ds": {
  30.         "downgraded": false,
  31.         "enrolled": "Y",
  32.         "authentication_response": "N",
  33.         "version": "2.1.0"
  34.     },
  35.     "risk": {
  36.         "flagged": false
  37.     },
  38.     "customer": {
  39.         "id": "cus_lxuppkhxqzfetaaaoxmjvxeybm",
  40.         "email": "abc@163.com"
  41.     },
  42.     "shipping": {
  43.         "address": {
  44.             "address_line1": "Checkout.com",
  45.             "address_line2": "90 Tottenham Court Road",
  46.             "city": "London",
  47.             "state": "London",
  48.             "zip": "W1T 4TJ",
  49.             "country": "HK"
  50.         },
  51.         "phone": {
  52.             "country_code": "1",
  53.             "number": "415 555 2671"
  54.         }
  55.     },
  56.     "actions": [],
  57.     "_links": {
  58.         "self": {
  59.             "href": "https://api.sandbox.checkout.com/payments/pay_iag2yexmxktkjpvvk4rdp2qvwi"
  60.         },
  61.         "actions": {
  62.             "href": "https://api.sandbox.checkout.com/payments/pay_iag2yexmxktkjpvvk4rdp2qvwi/actions"
  63.         }
  64.     }
  65. }
  1. 3DS验证成功

除了包含3DS相关信息外，在action这个object中还会返回authorization或capture的结果

  1. {
  2.     "id": "pay_eehq4zhpwzdkfbzz6si722uoqu",
  3.     "requested_on": "2022-06-29T09:03:16Z",
  4.     "source": {
  5.         "id": "src_hdsc6vjgjnwexphsly46tbuu6e",
  6.         "type": "card",
  7.         "billing_address": {
  8.             "country": "HK"
  9.         },
  10.         "expiry_month": 2,
  11.         "expiry_year": 2023,
  12.         "scheme": "Visa",
  13.         "last4": "4242",
  14.         "fingerprint": "67CF46597CE027875ED8230F168703A1D49E8D10622180AE58BB08813B3233D3",
  15.         "bin": "424242",
  16.         "card_type": "Credit",
  17.         "card_category": "Consumer",
  18.         "issuer": "JPMORGAN CHASE BANK NA",
  19.         "issuer_country": "US",
  20.         "product_id": "A",
  21.         "product_type": "Visa Traditional",
  22.         "avs_check": "S",
  23.         "cvv_check": "Y",
  24.         "payouts": true,
  25.         "fast_funds": "d"
  26.     },
  27.     "amount": 300,
  28.     "currency": "USD",
  29.     "payment_type": "Regular",
  30.     "reference": "PAYIN-TOPUP",
  31.     "description": "Set of 3 masks",
  32.     "status": "Captured",
  33.     "approved": true,
  34.     "3ds": {
  35.         "downgraded": false,
  36.         "enrolled": "Y",
  37.         "authentication_response": "Y",
  38.         "cryptogram": "AAABAVIREQAAAAAAAAAAAAAAAAA=",
  39.         "xid": "28d018f8-4e6f-4ac3-a541-36a462715567",
  40.         "version": "2.1.0"
  41.     },
  42.     "risk": {
  43.         "flagged": false
  44.     },
  45.     "customer": {
  46.         "id": "cus_lxuppkhxqzfetaaaoxmjvxeybm",
  47.         "email": "abc@163.com"
  48.     },
  49.     "billing_descriptor": {
  50.         "name": "",
  51.         "city": "London"
  52.     },
  53.     "shipping": {
  54.         "address": {
  55.             "address_line1": "Checkout.com",
  56.             "address_line2": "90 Tottenham Court Road",
  57.             "city": "London",
  58.             "state": "London",
  59.             "zip": "W1T 4TJ",
  60.             "country": "HK"
  61.         },
  62.         "phone": {
  63.             "country_code": "1",
  64.             "number": "415 555 2671"
  65.         }
  66.     },
  67.     "eci": "05",
  68.     "scheme_id": "511146744364556",
  69.     "actions": [
  70.         {
  71.             "id": "act_wfhatmkcuat25iel7thkbfkj6a",
  72.             "type": "Capture",
  73.             "response_code": "10000",
  74.             "response_summary": "Approved"
  75.         },
  76.         {
  77.             "id": "act_eehq4zhpwzdkfbzz6si722uoqu",
  78.             "type": "Authorization",
  79.             "response_code": "10000",
  80.             "response_summary": "Approved"
  81.         }
  82.     ],
  83.     "_links": {
  84.         "self": {
  85.             "href": "https://api.sandbox.checkout.com/payments/pay_eehq4zhpwzdkfbzz6si722uoqu"
  86.         },
  87.         "actions": {
  88.             "href": "https://api.sandbox.checkout.com/payments/pay_eehq4zhpwzdkfbzz6si722uoqu/actions"
  89.         },
  90.         "refund": {
  91.             "href": "https://api.sandbox.checkout.com/payments/pay_eehq4zhpwzdkfbzz6si722uoqu/refunds"
  92.         }
  93.     }
  94. }