Accept payments with South Korean issuer-authenticated cards
Note: Translation in progress.
本文为您介绍如何通过托管模式实现韩国认证卡支付的集成。由于韩国本地卡支付不支持 3DS 认证，导致数字娱乐等特定行业的商户面临支付限额约束。为提升交易额度并有效降低风险，建议您接入韩国认证卡支付方式。
在韩国认证卡支付场景下，每一笔支付均需完成认证流程。借助托管模式，Antom 为您提供一个支付中间页，供您的买家选择所需的卡品牌。您无需直接处理卡品牌选择逻辑，也无需接触买家的支付数据，从而在保障安全性与合规性的前提下，为买家提供无缝和可靠的支付体验。
用户体验
以下图片展示了接入韩国认证卡支付的用户体验：
支付流程
使用韩国认证卡支付的支付流程包括以下步骤：
- 买家选择商品后下单。
- 发起支付请求。
商户服务端调用 支付（单笔支付）接口以获取支付推进链接。 - 买家跳转至银行选择页。
Antom 通过 支付（单笔支付）接口的响应返回支付推进链接（normalUrl），并由商户客户端展示支付方式中间页，供您的买家选择所需的韩国认证卡品牌。随后，买家跳转至所选的韩国认证卡支付页面，完成支付后返回商户支付结果页。 - 获取授权支付结果。
商户服务端接收 Antom 返回的支付结果通知，并根据结果进行相应的处理。 - 获取请款结果。
支付成功后，Antom 会自动为您发起请款。之后您可以通过以下两种方法之一获取请款结果：
- 异步通知：在 支付（单笔支付）接口中设置 paymentNotifyUrl 参数，以指定接收异步通知的地址。当支付成功或过期时，Antom 会使用 请款通知（单笔支付）接口向您发送异步通知。
- 主动查询：调用 支付结果查询 接口来查询支付请求状态。
集成准备
在您开始集成前，请阅读集成指南及接口概述文档，了解服务端接口的集成步骤及调用接口的注意事项，并确保已完成以下预配置：
- 已获得 client ID。
- 已完成密钥配置。
- 已完成异步通知接收地址的配置。
- 集成服务端 SDK 资源包，并完成接口库安装及请求示例初始化。具体操作请参阅服务端 SDK。
集成步骤
请按照以下步骤开始集成：
- 发起支付请求
- 跳转至银行品牌选择页
- 获取授权支付结果
- 获取请款结果
步骤 1：发起支付请求
按照步骤 1：授权支付的操作调用 支付（单笔支付）接口提交支付请求，并在支付请求中传入基础参数、订单参数和设备参数，同时，您无需传入卡支付相关参数和 3DS 信息，但需要传入以下参数：
参数名称 | 是否必需 | 描述 |
requireIssuerAuthentication | 是 | 韩国认证卡支付场景下，此值需设为 |
selectedCardBrand | 否 | 买家选择的支付卡品牌。韩国认证卡支付场景下，当 requireIssuerAuthentication 为 |
isAuthorization.captureMode | 否 | 请款模式。韩国认证卡场景下，默认且仅支持由 Antom 为您自动请款。请保持默认值 |
以下代码展示了一个请求报文的示例：
{
"env": {
"osType": "ANDROID",
"terminalType": "WAP",
"clientIp": "192.168.1.1"
},
"order": {
"orderAmount": {
"currency": "KRW",
"value": "46000"
},
"orderDescription": "클룩과 함께 떠날 즐거운 시간",
"referenceOrderId": "referenceOrderId01",
"buyer": {
"buyerEmail": "xxx @xxx.com"
}
},
"paymentAmount": {
"currency": "KRW",
"value": "46000"
},
"paymentFactor": {
"isAuthorization": true
},
"paymentMethod": {
"paymentMethodType": "CARD",
"paymentMethodMetaData": {
"selectedCardBrand": "HYUNDAI", // 可选参数，用于指定卡品牌，跳过Antom银行列表选择页
"requireIssuerAuthentication": true
}
},
"paymentNotifyUrl": "https://www.yourNotifyUrl.com",
"paymentRedirectUrl": "https://www.yourMerchantWeb.com",
"paymentRequestId": "paymentRequestId01",
"productCode": "CASHIER_PAYMENT",
"settlementStrategy": {
"settlementCurrency": "KRW"
}
}以下代码展示了发起支付后的响应报文示例，其不会直接返回授权支付结果，而是返回 normalUrl 以引导买家跳转至支付方式页面进行支付：
{
"normalUrl": "https://payment-gateway.tosspayments.com/link/payment?urlToken=checkout-url-****",
"paymentActionForm": "{\"method\":\"GET\",\"paymentActionFormType\":\"RedirectActionForm\",\"redirectUrl\":\"https://payment-gateway.tosspayments.com/link/payment?urlToken=checkout-url-****\"}",
"paymentAmount": {
"currency": "KRW",
"value": "46000"
},
"paymentCreateTime": "2025-12-16T18:09:37-08:00",
"paymentId": "20251217194******0236670295",
"paymentRequestId": "paymentRequestId01",
"paymentResultInfo": {
"avsResultRaw": "",
"cvvResultRaw": "",
"threeDSResult": {
"cavv": "",
"eci": ""
}
},
"paymentTime": "2025-12-16T18:09:38-08:00",
"redirectActionForm": {
"method": "GET",
"redirectUrl": "https://payment-gateway.tosspayments.com/link/payment?urlToken=checkout-url-****"
},
"result": {
"resultCode": "PAYMENT_IN_PROCESS",
"resultMessage": "payment in process",
"resultStatus": "U"
}
}步骤 2：跳转至银行品牌选择页
商户服务端通过 支付（单笔支付）响应获取到 normalUrl 后，需将该 normalUrl 链接传递给客户端，由商户客户端跳转至银行支付页或展示银行品牌选择页，具体体验如下：
银行支付页 | Antom 中间页 |
如您在 支付（单笔支付）接口的 selectedCardBrand 参数中指定了买家支付的卡品牌，买家将直接跳转至该银行支付页面。 此时 Antom 返回的 normalUrl 示例如下： 以下图片展示了买家直接跳转银行支付页面的用户体验：
| 如您未设置 selectedCardBrand 参数，买家会在 Antom 托管的银行品牌选择页选择所需的韩国认证卡品牌，随后跳转至所选的韩国认证卡支付页面。 此时 Antom 返回的 normalUrl 示例如下： 以下图片展示了买家跳转至 Antom 中间页选择卡品牌的用户体验：
|
按照步骤 2：跳转至卡信息采集页面的操作来处理获取到的 normalUrl。
步骤 3：获取授权支付结果
按照步骤 3：获取授权支付结果的操作获取授权支付结果。
步骤 4：获取请款结果
支付成功后，Antom 将自动为您发起请款，您可以通过异步通知或主动查询来获取请款结果。您需凭借请款成功结果作为发货依据。
注意：韩国认证卡支付场景只支持由 Antom 自动为您发起请款，且不支持取消授权支付成功的订单。
支付后操作
完成支付后，您可对交易进行以下支付后的操作：
取消交易
韩国认证卡支付场景不支持取消授权支付成功的订单。对于尚未完成支付的订单，您可以进行取消，具体操作请参阅取消交易。
退款
不同支付方式的退款能力各有差异，若您需要了解 Antom 的退款规则及如何对成功的交易发起退款，请参阅退款。
争议
当某笔交易发生争议时，Antom 为您提供争议处理相关服务。更多信息请参阅争议运营手册。