Co-badged cards

2026-01-16 09:35

Note: Translation in progress.

在服务端-服务端式卡支付场景下，当买家输入双标卡卡号时，您可直接将其传入给 Antom 的支付请求中，Antom 将自动智能决策最优卡品牌完成支付，无需您对双标卡号做额外处理，提升了支付的便捷性。数据显示，Antom 智能决策的支付成功率显著高于您自行指定卡品牌的模式。

注意：在欧洲经济区（EEA），为符合欧洲消费者保护法规，若买家使用双标卡进行授权支付，需提示买家自主选择卡品牌，并通过 selectedCardBrand 参数明确传入所选的品牌。指定卡品牌具体步骤请参见指定银行卡品牌。

如何启用

双标卡支付的处理流程如下图所示：

双标卡.png

当买家输入双标卡卡号时，直接将卡号传入支付请求的 cardNo 参数中：

copy
"paymentMethodMetaData": {
    "cardholderName": {
        "firstName": "Lady",
        "lastName": "Gaga"
    },
    "cvv": "850",
    "expiryMonth": "12",
    "expiryYear": "29",
    "cardNo": "4390********8888",
    "selectedCardBrand": "VISA"
}

双标卡合规要求

本章节为您介绍在欧洲经济区（EEA）内集成双标卡支付方案的要求，使您能够接受各种双标卡交易。作为商户，您需要遵守欧洲消费者保护法规的要求，并为持卡人提供更清晰、更便捷的支付方案。

合规准则

依据欧盟法规 (EU) 2015/751，无论您的注册地是否在欧洲，只要接收欧洲经济区（EEA）消费者的双标卡支付，就必须满足合规性的要求。

集成要求

要有效地集成双标卡支付方案，您必须遵守以下要求：

展示可用的支付方案：展示您接受的所有与 EEA 发行的双标卡相关的支付方案。确保在结账页面上，每个选项的视觉呈现（大小和标识）保持一致。不要隐藏其他选项。
尊重持卡人的选择：当持卡人选择偏好支付方案时，您需要尊重这一选择并继续交易。不得改变持卡人选择的支付方案。
存储支付方式选项：当持卡人选择偏好支付方式时，您可以提示持卡人完成独立的银行绑卡以存储银行卡信息。这将使后续支付流程更加顺畅。

通过遵循合规准则，您可以集成双标卡支付方式，为持卡人提供更好的支付体验。请注意，在集成双标卡支付方式时，您需要遵守相关的安全和隐私保护要求，以确保支付过程安全可靠。

指定银行卡品牌

商户端收集明文银行卡信息，并使用接口集成银行卡支付。如果买家选择了双标卡进行授权支付，您可以通过 selectedCardBrands 参数指定交易中使用银行卡品牌的地区。

注意：
如果不设置 selectedCardBrands，Antom 将为您选择一个银行卡品牌进行授权支付。
如果您接受欧洲双标卡，需要向买家提供清晰的支付方案。详情请参考双标卡合规要求。

对应的请求示例如下：

copy
{
    "order": {
        "orderAmount": {
            "currency": "EUR",
            "value": "30000"
        },
        "orderDescription": "《Bad Romance》-Lady Gaga",
        "referenceOrderId": "ORDER_20231208111545328",
        "goods": [
            {
                "goodsCategory": "Digital Goods",
                "goodsName": "《Bad Romance》",
                "goodsQuantity": "1",
                "goodsUnitAmount": {
                    "currency": "HKD",
                    "value": "30000"
                },
                "goodsUrl": "https://www.youtube.com/watch?v=QdaG6pDOz5A",
                "referenceGoodsId": "GOODS_20231208111545328"
            }
        ],
        "shipping": {
            "shippingName": {
                "firstName": "lady",
                "fullName": "lady gaga",
                "lastName": "gaga"
            },
            "shippingPhoneNo": "123456789"
        },
        "buyer": {
            "buyerEmail": "gaga@gaga.com",
            "buyerName": {
                "firstName": "lady",
                "fullName": "lady gaga",
                "lastName": "gaga"
            },
            "buyerPhoneNo": "123456789",
            "referenceBuyerId": "88888888"
        }
    },
    "env": {
        "terminalType": "WEB",
        "clientIp": "112.80.248.78",
        "deviceId": "eYOIkvFpZzztgO0Yu6USdprBQZCWxDhiUAHCiK8K/cH9mT6wMaMO****",
        "deviceLanguage": "zh_CN"
    },
    "paymentAmount": {
        "currency": "EUR",
        "value": "30000"
    },
    "paymentMethod": {
        "paymentMethodType": "CARD",
        "paymentMethodMetaData": {
            "cardholderName": {
                "firstName": "Lady",
                "lastName": "Gaga"
            },
            "billingAddress": {
                "zipCode": "310000",
                "address2": "Xihu",
                "city": "Hangzhou",
                "address1": "Wuchang road",
                "state": "Zhejiang",
                "region": "CN"
            },
            "cvv": "850",
            "expiryMonth": "12",
            "expiryYear": "29",
            "cardNo": "4390807888888888",
            "selectedCardBrand": "VISA"
        }
    },
    "settlementStrategy": {
        "settlementCurrency": "SGD"
    },
    "paymentNotifyUrl": "https://kademo.intlalipay.cn/payments/notifySuccess",
    "paymentRedirectUrl": "https://kademo.intlalipay.cn/melitigo/Test_114.html",
    "paymentRequestId": "PAY_2023154445445328",
    "productCode": "CASHIER_PAYMENT",
    "paymentFactor": {
        "isAuthorization": true
    }
}