分期支付

分期支付是一种流行的信用卡支付方式，允许买家在购买商品或服务时无需一次性付清全款，而是将总金额分摊到多个月进行支付。系统会每隔 30 天自动从买家的信用卡中扣除约定金额，直至款项全部结清。
不同国家/地区的分期支付规则和流程可能存在差异，例如，巴西支持信用卡分期支付，且通常不收取分期手续费；韩国支持信用卡和部分借记卡分期支付，手续费政策根据银行促销活动定期调整，可能提供全额或部分免息优惠。目前，Antom 支持在美国、日本、巴西、韩国、墨西哥、智利地区提供卡分期支付服务。如需了解具体区域的支持情况请联系 Antom 技术支持。
分期支付功能可为您带来以下优势：
  • 提升消费能力与购买意愿：买家无需一次性支付大额费用，可将高价值商品（如电子产品、家具或教育课程）的支出分摊到数月，减轻短期资金压力。
  • 灵活的还款选择：买家可根据自身需求选择分期期数（如 3 期、6 期或 12 期），更好地匹配个人或家庭的预算规划。
  • 提高交易客单价：分期支付降低了买家的购买门槛，使其更愿意选择高价值商品，从而有助于提升单笔交易金额。

获取银行卡品牌分期信息

以下是不同地区的卡支付方式支持的分期支付信息：

Visa、Mastercard 和 Discover

在美国，此分期支付解决方案允许客户使用现有的信用卡分摊购买，商户会预先收到全部的交易金额。分期支付无缝集成到 Antom 现有的支付流程中，帮助商户在结账时提供更大的灵活性，而无需改变结算或资金管理。

支持的线上支付集成

此分期解决方案仅支持单笔支付，以下是支持的集成：

请款模式

仅支持并推荐自动请款模式。不支持手动请款，且不会作为集成选项提供。

pay 接口的必填字段

pay (单笔支付) 请求中必须包含以下字段：

createPaymentSession 接口的必填字段

createPaymentSession (单笔支付) 请求中必须包含以下字段：

Visa、Mastercard、American Express 和 JCB

对于日本商户，Antom 支持以上卡品牌的分期支付交易。参阅 Visa, Mastercard, American Express, and JCB 的支付方式手册，获取 AntomJP 下对应卡品牌的详细分期信息。

Brazilian cards、Mexican cards 和 Chilean cards

参阅 Brazilian cards、Mexican cards 和 Chilean cards 的支付方式手册，获取对应卡品牌支持的最大、最小支付金额及支持的分期计划。

South Korean Cards

South Korean Cards 支付支持的分期计划为 2 至 12 期，但分期免息营销信息会动态调整，您可通过以下两种方式获取最新信息：
  • 定期查询支付方式手册：建议每月查询一次，可获取各卡品牌全额免息与部分免息的详细信息。
  • 调用 consult 接口（仅获取全额免息信息）：通过 consult 接口可实时查询全额免息信息，但无法获取部分免息信息。以下是接口响应的示例代码，其中包含以下分期信息参数：
    • installment.plan：支持的分期期数。
    • supportCardBrands：支持的卡品牌。
    • promotionInfos.interestFree：具体卡品牌支持全额免息的期数。
注意：调用 consult 接口获取免息信息前请联系 Antom 技术支持进行后台配置。
{
"paymentOptions": [
  ...
  {
    ...
    "installment": {
      "plans": [
        {
          "enabled": true,
          "installmentNum": "2",
          "interestRate": "0.00",
          "interval": "MONTH",
          "maxInstallmentAmount": {},
          "minInstallmentAmount": {
            "currency": "KRW",
            "value": "50000"
          }
        },
        {
          "enabled": true,
          "installmentNum": "3",
          "interestRate": "0.00",
          "interval": "MONTH",
          "maxInstallmentAmount": {},
          "minInstallmentAmount": {
            "currency": "KRW",
            "value": "50000"
          }
        },
        ...
        {
          "enabled": true,
          "installmentNum": "12",
          "interestRate": "0.00",
          "interval": "MONTH",
          "maxInstallmentAmount": {},
          "minInstallmentAmount": {
            "currency": "KRW",
            "value": "50000"
          }
        }
      ],
      "supportCardBrands": [
        {
          "cardBrand": "BC",
          "logo": {
            "logoName": "BC",
            "logoUrl": "https://cdn.marmot-cloud.com/storage/2022/12/20/a0b5af56-4c94-4f77-afb4-ab99a17f3662.svg"
          }
        },
        ...
        {
          "cardBrand": "JEJUBANK",
          "logo": {
            "logoName": "JEJUBANK",
            "logoUrl": "https://cdn.marmot-cloud.com/storage/2024/3/25/f9e65ee6-32db-465c-8e7f-c0a8d41d2533.svg"
          }
        }
      ]
    },
    "promotionInfos": [
      {
        "interestFree": {
          "expireTime": "2025-11-30T14:59:59Z",
          "freePercentage": 100,
          "installmentFreeNums": [
            2,
            3,
            4,
            5
          ],
          "minPaymentAmount": {
            "currency": "KRW",
            "value": "50000"
          },
          "provider": "KOOKMIN"
        },
        "promotionType": "INTEREST_FREE"
      },
      {
        "interestFree": {
          "expireTime": "2025-11-30T14:59:59Z",
          "freePercentage": 100,
          "installmentFreeNums": [
            2,
            3,
            4,
            5
          ],
          "minPaymentAmount": {
            "currency": "KRW",
            "value": "50000"
          },
          "provider": "BC"
        },
        "promotionType": "INTEREST_FREE"
      },
      ...
    ]
  }
],
"result": {
  "resultCode": "SUCCESS",
  "resultMessage": "success.",
  "resultStatus": "S"
}
}

如何启用

注意：如果不通过 creditPayPlan 指定分期信息，支付将默认为非分期支付。
托管式卡支付集成
服务端-服务端式卡支付集成
SDK 集成
根据 notifyPayment 接口向您发送的授权支付结果异步通知，您可通过其中的 paymentResultInfo.creditPayPlan 参数获知买家是否分期以及对应的分期数。以下代码展示了一个异步通知的示例：
{
"actualPaymentAmount": {
  "currency": "KRW",
  "value": "131020"
},
"cardInfo": {
  "avsResultRaw": "",
  "cardBrand": "SHINHAN",
  "cardCategory": "CONSUMER",
  "cardNo": "************4735",
  "credentialTypeUsed": "PAN",
  "creditPayPlan": {
    "installmentNum": 3,
    "interval": "MONTH"
  },
  "cvvResultRaw": "",
  "funding": "CREDIT",
  "issuingCountry": "KR",
  "paymentMethodRegion": "KR",
  "threeDSResult": {
    "cavv": "",
    "challengeCancel": "",
    "challenged": false,
    "eci": "",
    "threeDSOffered": false,
    "threeDStransactionStatusReason": ""
  }
},
"notifyType": "PAYMENT_RESULT",
"paymentAmount": {
  "currency": "KRW",
  "value": "131020"
},
"paymentCreateTime": "2026-01-05T18:56:59-08:00",
"paymentId": "2026010619*******0242270687",
"paymentRequestId": "1015202601*******84010019",
"paymentResultInfo": {
  "avsResultRaw": "",
  "cardBrand": "SHINHAN",
  "cardCategory": "CONSUMER",
  "cardNo": "************4735",
  "credentialTypeUsed": "PAN",
  "creditPayPlan": {
    "installmentNum": 3,
    "interval": "MONTH"
  },
  "cvvResultRaw": "",
  "funding": "CREDIT",
  "issuingCountry": "KR",
  "paymentMethodRegion": "KR",
  "threeDSResult": {
    "cavv": "",
    "challengeCancel": "",
    "challenged": false,
    "eci": "",
    "threeDSOffered": false,
    "threeDStransactionStatusReason": ""
  }
},
"paymentTime": "2026-01-05T18:57:01-08:00",
"result": {
  "resultCode": "SUCCESS",
  "resultMessage": "success.",
  "resultStatus": "S"
}
}