Antom, leading provider of tailored payment solutionsAntom, leading provider of tailored payment solutions

Card-on-File (COF)

Note: Translation in progress.

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

如何启用

当买家使用已存卡发起支付时，您需要将 支付会话创建（收银台）接口中的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 错误码，建议您引导买家重新绑定以更新卡信息。