卡信息存档交易（COF）

2026-01-19 14:58

注意：本文档已停止维护并下线归档，请访问 https://docs.antom.com/ 获取最新内容。

COF（Card-on-File）指在交易中，买家使用的是曾在商户侧完成过支付的已存卡。获得买家授权后，您可自行存储卡信息或由 Antom 代存，当您的买家使用存储的卡信息进行支付时，强烈建议您在请求中标记该笔交易为已存卡支付。通过已存卡支付可有效降低卡组与发卡行的拒绝率，并提升支付成功率。本文为您介绍如何启用 COF。

如何启用

Payment Element 集成

托管式卡支付集成

服务端-服务端式卡支付集成

Checkout Page (CKP) 集成

当买家使用已存卡发起支付时，您需要将 支付会话创建（单笔支付）接口中的availablePaymentMethod.paymentMethodMetaData.isCardOnFile 设为 true 以识别已存卡支付。

以下代码展示了由 Antom 存储卡信息并使用 Antom 提供的 cardToken 发起后续交易的请求报文：

copy
{
  ...
    "availablePaymentMethod": {
        "paymentMethodMetaData": {
            "isCardOnFile": true
        }
    },  
  "savedPaymentMethods": [
        {
            "paymentMethodType": "CARD",
            "paymentMethodId": "ALIPAYEfG2DFbGx2Eh739qU+VMnCPEe7MfRKfMfC5k7k/IFASWpAh/vCxHV3dPYpbkGz1iyWCloE4MwfmN48sP8+rSPQ=="
        }
    ]
  ...
}

注意：在 COF 交易中，可能出现因为买家卡过期导致交易失败的情况，此时 Antom 会返回 INVALID_EXPIRATION_DATE 错误码，建议您引导买家重新绑定以更新卡信息。