Korean Virtual Account

Korean Virtual Account 是韩国常用的支付方式。当客户通过虚拟账户发起支付时，会以客户名义开立一个临时账户。客户通过在规定时间内将订单金额存入指定账户完成支付。

产品特性

Korean Virtual Account 的产品特性如下表所示：

用户体验

注意：以下不同终端的支付流程代表该支付方式在不同终端类型上的流程，仅供参考。关于支持的商户终端类型，请咨询 Antom 技术支持。

下图展示了不同场景下使用 Korean Virtual Account 支付的流程：

无 Antom 页面的支付

此场景下，商户侧展示 Korean Virtual Account 内容。

Web

App

1. 买家选择 Korean Virtual Account 进行支付，并选择一家银行以开立 Korean Virtual Account。
2. 买家跳转到显示生成的虚拟账号的页面，并复制该号码。
3. 买家打开银行应用程序，输入虚拟账号和交易金额以完成支付。
4. 买家跳转回商户结果页面。

注意：步骤 3 的具体流程呈现取决于您在步骤 1 中选择的银行。

有 Antom 页面的支付

此场景下，Antom 侧展示 Korean Virtual Account 内容。

Web

App

1. 买家选择 Korean Virtual Account 进行支付。
2. 买家跳转到 Antom 页面，并选择一家银行以开立 Korean Virtual Account。
3. 买家复制生成的虚拟账号号码。
4. 买家打开银行应用程序，输入虚拟账号和交易金额以完成支付。
5. 买家跳转回商户结果页面。

注意：步骤 4 的具体流程呈现取决于您在步骤 2 中选择的银行。

支持的线上支付集成

Antom 提供了一系列针对每种支付方式量身定制的集成选项。每种支付方式可能支持不同的线上支付集成选项，可根据您的业务需求进行灵活配置。下表提供了有关每种支付方式可用的特定集成的详细信息：

集成注意事项

以下部分概述了不同支付方式的集成考虑，详细介绍了定制化的集成解决方案和支付方式的特点。

关于银行识别码

在使用 Korean Virtual Account 支付时，您需要向买家收集银行代码。银行识别码可以通过 Antom 中间页面或直接从商户页面收集。

• Antom 中间页：在 pay（单笔支付）接口请求中，如果没有传入 bankIdentifierCode 参数，接口响应中会返回normalUrl 参数。您需要将买家重定向到 normalUrl 指定的地址，并按照用户体验中的指示继续支付流程。
• 商户页面：您可以展示银行列表以供买家选择，并在 pay（单笔支付）接口请求中指定为 bankIdentifierCode 参数。之后，您可以直接在商户页面渲染接口响应中的 codeValue 参数来展示 Korean Virtual Account 号码，减少页面跳转，提升支付体验。

默认关单时间

• 您可以使用 pay（单笔支付）接口请求中的 paymentExpiryTime 参数来定义每个 Korean Virtual Account 的关单时长。默认关单时间为 168 小时（7 天）。
• 当展示 Korean Virtual Account 号码时，您可以使用在 pay（单笔支付）接口响应中返回的 expireTime 参数值来显示支付超时时间。当号码展示时，您可以启用号码的复制功能，方便买家将号码粘贴到支付方式应用中。
• 支付超时后将无法进行存款或转账。

注意：最长关单时间为 90 天。

代码示例

以下是 pay（单笔支付）响应中的示例代码：

{
    "orderCodeForm": {
        "codeDetails": [
            {
                "codeValue": "8007065324039",
                "displayType": "TEXT"
            }
        ],
        "expireTime": "*************************"
    },
    "paymentActionForm": "{\"paymentActionFormType\":\"PaymentCodeForm\",\"paymentCodeExpireTime\":1768472708000,\"paymentCodeInfos\":[{\"paymentCodeDetails\":[{\"codeValue\":\"8007065324039\",\"codeValueType\":\"DIGICODE\",\"displayType\":\"TEXT\"}],\"paymentCodeInfoType\":\"PAYMENT_CODE\"}]}",
    "paymentAmount": {
        "currency": "KRW",
        "value": "200"
    },
    "paymentCreateTime": "2026-01-08T02:25:08-08:00",
    "paymentId": "20260108194010800100188810241505521",
    "paymentRequestId": "PAYMENT_20260108182507029_AUTO",
    "result": {
        "resultCode": "PAYMENT_IN_PROCESS",
        "resultMessage": "payment in process",
        "resultStatus": "U"
    }
}