Antom, leading provider of tailored payment solutions

卡信息存档交易(COF)

注意:本文档已停止维护并下线归档,请访问 https://docs.antom.com/ 获取最新内容。
COF(Card-on-File)指在交易中,买家使用的是曾在商户侧完成过支付的已存卡。获得买家授权后,您可自行存储卡信息或由 Antom 代存,当您的买家使用存储的卡信息进行支付时,强烈建议您在请求中标记该笔交易为已存卡支付。通过已存卡支付可有效降低卡组与发卡行的拒绝率,并提升支付成功率。本文为您介绍如何启用 COF。

如何启用

Payment Element 集成
当买家使用已存卡发起支付时,您需要将 支付会话创建(单笔支付)接口中的availablePaymentMethod.paymentMethodMetaData.isCardOnFile 设为 true  以识别已存卡支付。
以下代码展示了由 Antom 存储卡信息并使用 Antom 提供的 cardToken 发起后续交易的请求报文:
json
{
  ...
    "availablePaymentMethod": {
        "paymentMethodMetaData": {
            "isCardOnFile": true
        }
    },  
  "savedPaymentMethods": [
        {
            "paymentMethodType": "CARD",
            "paymentMethodId": "ALIPAYEfG2DFbGx2Eh739qU+VMnCPEe7MfRKfMfC5k7k/IFASWpAh/vCxHV3dPYpbkGz1iyWCloE4MwfmN48sP8+rSPQ=="
        }
    ]
  ...
}
托管式卡支付集成
当买家使用已存卡发起支付时,您需要将 支付(单笔支付)接口中的 paymentMethod.paymentMethodMetaData.isCardOnFile 设为 true 以识别已存卡支付。
以下代码展示了由 Antom 存储卡信息并使用 Antom 提供的 cardToken 发起后续交易的请求报文:
json
"paymentMethod":
    {
        "paymentMethodMetaData":
        {
            "isCardOnFile": true
        },
        "paymentMethodType": "CARD",
        "paymentMethodId": "ALIPAYgzViZ*********RWZIU31kU+2avs5dAgkzss/NrTymfnc/0+xI0ssHmyU3VyWCloE4MwfmN48sP1+rSPQ=="
    }
服务端-服务端式卡支付集成
当买家使用已存卡发起支付时,您需要将 支付(单笔支付)接口中的 paymentMethod.paymentMethodMetaData.isCardOnFile 设为 true 以识别已存卡支付。

Antom 存储卡信息 推荐

建议您选择由 Antom 存储卡信息并使用 Antom 提供的 cardToken 发起后续支付。数据显示,使用 Antom 代存卡信息并使用 token 发起后续交易的成功率远高于您自行存卡的方式。
以下代码展示了使用 Antom 提供的 cardToken 进行后续支付的请求报文:
json
"paymentMethod":
    {
        "paymentMethodMetaData":
        {
            "isCardOnFile": true
        },
        "paymentMethodType": "CARD",
        "paymentMethodId": "AL****************PQ=="
    }

自行存储卡信息

如您选择自行存储卡信息,您需要在后续交易中传入 cardNo、expiryYear、expiryMonth、cardholderName 和 isCardOnFile,但无需传入 cvv。
以下代码展示了由您自行存储卡信息进行后续支付的请求报文:
json
"paymentMethod":
    {
        "paymentMethodMetaData":
        {
            "cardholderName":
            {
                "firstName": "Tom",
                "lastName": "Jerry"
            },
            "expiryMonth": "11",
            "expiryYear": "28",
            "cardNo": "41************54",
            "isCardOnFile": true
        },
        "paymentMethodType": "CARD"
    },
Checkout Page (CKP) 集成
当买家使用已存卡发起支付时,您需要将 支付会话创建(单笔支付)接口中的availablePaymentMethod.paymentMethodMetaData.isCardOnFile 设为 true  以识别已存卡支付。
以下代码展示了由 Antom 存储卡信息并使用 Antom 提供的 cardToken 发起后续交易的请求报文:
json
{
  ...
    "availablePaymentMethod": {
        "paymentMethodMetaData": {
            "isCardOnFile": true
        }
    },  
  "savedPaymentMethods": [
        {
            "paymentMethodType": "CARD",
            "paymentMethodId": "ALIPAYEfG2DFbGx2Eh739qU+VMnCPEe7MfRKfMfC5k7k/IFASWpAh/vCxHV3dPYpbkGz1iyWCloE4MwfmN48sP8+rSPQ=="
        }
    ]
  ...
}
注意:在 COF 交易中,可能出现因为买家卡过期导致交易失败的情况,此时 Antom 会返回 INVALID_EXPIRATION_DATE 错误码,建议您引导买家重新绑定以更新卡信息。