使用Clover API发起AMEX支付报402错误，Visa等卡种正常

问题概述 #

使用Clover API的chargesRequest接口（地址：scl-sandbox.dev.clover.com/v1/charges）发起支付时，American Express（AMEX）卡返回402 Payment Required状态码，错误详情为CVV could not be verified且declineCode: issuer_declined；但Visa、Discover、MasterCard（MC）卡可正常完成支付。

案例详情 #

AMEX支付失败案例 #

响应内容

{
  "message": "402 Payment Required",
  "error": {
    "code": "card_declined",
    "message": "CVV could not be verified",
    "charge": "KS1DF4QDJCB6M",
    "declineCode": "issuer_declined"
  }
}

请求载荷

{
  "ecomind": "ecom",
  "metadata": {
    "existingDebtIndicator": false
  },
  "amount": "45",
  "currency": "USD",
  "source": "clv_1TSTSkXPsbmgFu6iyD3E574E"
}

Visa/Discover/MC支付成功案例 #

响应内容

{
  "id": "QQZ563DJV8C8G",
  "amount": 45,
  "payment_method_details": "card",
  "amount_refunded": 0,
  "currency": "USD",
  "created": 1697200129357,
  "captured": true,
  "ref_num": "328600501790",
  "auth_code": "OK9112",
  "outcome": {
    "network_status": "approved_by_network",
    "type": "authorized"
  },
  "paid": true,
  "status": "succeeded",
  "source": {
    "id": "clv_1TSTSHMb94DAyMQ8gQG5NCfH",
    "brand": "VISA",
    "exp_month": "06",
    "exp_year": "2025",
    "first6": "424242",
    "last4": "4242"
  },
  "ecomind": "ecom"
}

请求载荷

{
  "ecomind": "ecom",
  "metadata": {
    "existingDebtIndicator": false
  },
  "amount": "45",
  "currency": "USD",
  "source": "clv_1TSTSHMb94DAyMQ8gQG5NCfH"
}

排查与解决建议 #

• 验证AMEX卡CVV格式：AMEX的CVV为4位数字，其他卡为3位，确认创建source时是否正确提交了4位CVV，避免因格式不符导致验证失败。
• 确认测试卡有效性：检查使用的AMEX测试卡是否为Clover沙箱官方提供的有效测试卡，部分第三方测试卡可能触发发卡行模拟拒绝规则。
• 核对请求参数差异：对比成功与失败请求的所有参数，确认除source外其他参数完全一致；部分场景下AMEX可能需要额外参数，可查阅Clover官方文档确认。
• 检查商户AMEX权限：确认沙箱环境下的商户账号是否已开通AMEX支付通道权限，部分商户默认未启用该卡种。
• 联系Clover技术支持：若以上排查无结果，提供失败请求的charge ID（KS1DF4QDJCB6M），请求官方查询具体拒绝原因，沙箱环境可能存在特殊的发卡行配置。

内容的提问来源于stack exchange，提问作者Chandra