全托管模式

2025-06-09 07:35

Antom Checkout Page 是一款高效便捷的低代码集成支付页面产品，支持多种主流支付方式并覆盖全球多个地区，满足不同市场和场景的需求。通过简单的开发配置，您即可快速搭建一个界面专业、功能齐全的收银台页面，为买家提供流畅便捷的支付体验，同时显著提升支付接入效率，助力业务增长。

本方案通过接口实现集成，买家在完成商品加购后可直接跳转至 Antom Checkout Page 进行支付，无需额外页面配置。

用户体验

Mobile

下图展示一般场景下，从商户页面跳转至 Antom Checkout Page 的用户体验流程：

下图展示在部分支付方式需跳转的场景下，从商户页面跳转至 Antom Checkout Page，再跳转至第三方支付页面的用户体验流程：

支付流程

使用 Antom Checkout Page 全托管模式支付的流程包括以下步骤：

托管模式中文-新.png

买家在商户侧下单。
创建 支付会话创建（收银台） 请求。

当买家在商户侧下单，您需调用 支付会话创建（收银台） 接口获取 Antom Checkout Page 的 H5 链接。

处理 Antom Checkout Page URL。

商户前端加载 Antom Checkout Page URL，买家在 Checkout Page 上选择支付方式，然后完成支付。支付完成后会跳转至 Checkout Page 的结果页，然后再回到商户结果页。您也可以在 Antom Dashboard 配置直接跳转至商户结果页。

获取支付结果。

通过异步通知获取支付结果。在 支付会话创建（收银台） 接口中设置 paymentNotifyUrl 参数，以指定接收异步通知的地址。当支付请求成功或过期时，Antom 会通过 支付通知 接口向您发送异步通知。

支付集成步骤

请按照以下步骤开始集成：

创建支付会话
跳转至 Antom Checkout Page
异步通知处理

步骤 1：创建支付会话服务端

买家在商品详情或者购物车页面点击支付时可以选择 Antom 提供的支付方式。若需配置支付方式，请参见指定支付方式。当买家进行支付时，您需要收集关键信息，如支付请求 ID、订单信息、支付重定向链接和支付结果通知链接。您可以调用 支付会话创建（收银台）接口并传入订单信息，创建支付会话后跳转至 Antom Checkout Page。

1. 安装接口库

您可以在 GitHub 上找到最新版本。

copy
<dependency>
   <groupId>com.alipay.global.sdk</groupId>
   <artifactId>global-open-sdk-java</artifactId>
   <version>{latest_version}</version>
</dependency>

2. 初始化请求实例

创建一个单例资源以向 Antom 发起请求。

copy
import com.alipay.global.api.AlipayClient;
import com.alipay.global.api.DefaultAlipayClient;
import com.alipay.global.api.model.constants.EndPointConstants;

public class Sample {
    public static final String        CLIENT_ID            = "";
    public static final String        ANTOM_PUBLIC_KEY     = "";
    public static final String        MERCHANT_PRIVATE_KEY = "";

    private final static AlipayClient CLIENT               = new DefaultAlipayClient(
            EndPointConstants.SG, MERCHANT_PRIVATE_KEY, ANTOM_PUBLIC_KEY, CLIENT_ID);

}

3. 调用支付会话创建接口

以下示例代码展示了如何调用 支付会话创建（收银台）接口：

copy
public static void createPaymentSession() {
    AlipayPaymentSessionRequest alipayPaymentSessionRequest = new AlipayPaymentSessionRequest();
    alipayPaymentSessionRequest.setProductCode(ProductCodeType.CASHIER_PAYMENT);

    // 替换为您的 paymentRequestId 
    String paymentRequestId = UUID.randomUUID().toString();
    alipayPaymentSessionRequest.setPaymentRequestId(paymentRequestId);

    // 设置金额 
    Amount amount = Amount.builder().currency("SGD").value("4200").build();
    alipayPaymentSessionRequest.setPaymentAmount(amount);

    // 设置支付方式 
    PaymentMethod paymentMethod = PaymentMethod.builder().paymentMethodType("SHOPEEPAY_SG").build();
    alipayPaymentSessionRequest.setPaymentMethod(paymentMethod);

    // 替换为您的 orderId  
    String orderId = UUID.randomUUID().toString();

    // 设置买家信息
    Buyer buyer = Buyer.builder().referenceBuyerId("yourBuyerId").build();

    // 设置订单信息
    Order order = Order.builder().referenceOrderId(orderId)
        .orderDescription("antom testing order").orderAmount(amount).buyer(buyer).build();
    alipayPaymentSessionRequest.setOrder(order);

    // 替换为您的通知地址
    alipayPaymentSessionRequest.setPaymentNotifyUrl("https://www.yourNotifyUrl.com");

    // 替换为您的跳转地址
    alipayPaymentSessionRequest.setPaymentRedirectUrl("https://www.yourMerchantWeb.com");

    AlipayPaymentSessionResponse alipayPaymentSessionResponse = null;
    try {
        alipayPaymentSessionResponse = CLIENT.execute(alipayPaymentSessionRequest);
    } catch (AlipayApiException e) {
        String errorMsg = e.getMessage();
        // 处理错误情况
    }
}

4. 创建支付会话

如果您的支付方式中包含卡支付，支付会话参数中必须传入商户端的买家信息。详情请参见卡支付。

以下是请求参数重点字段：

类型	字段	是否必需	描述
基础字段	productCode	是	此场景下该字段的值固定为 `CASHIER_PAYMENT`。
	productScene	是	此场景下该字段的值固定为 `CHECKOUT_PAYMENT`。
	paymentRequestId	是	商户为识别支付请求而分配的专属 ID。
	paymentAmount	是	商户请求以订单币种收取的支付金额。
	paymentRedirectUrl	是	支付完成后买家被重定向到的商户页面链接。
	paymentNotifyUrl	否	支付结果通知地址，可通过接口指定或在 Antom Dashboard 上设置固定值。
	settlementStrategy	否	支付请求的结算策略。如果您签署了多个结算币种，需在接口中指定 settlementCurrency。
	locale	否	商户指定的 Antom Checkout Page 展示语言。如果该字段为空或设置为自动，则将使用浏览器的默认语言设置，通常为英文。
订单字段	order.orderAmount	是	商户端订单金额。
	order.referenceOrderId	是	商户端订单号。
	order.orderDescription	是	商户端订单描述。

以上参数是创建支付会话的基本参数，完整参数和特定支付方式的额外要求请参考 支付会话创建（收银台）。

以下代码展示了一个请求报文的示例：

copy
{
  "order": {
    "buyer": {
      "referenceBuyerId": "yourBuyerId"
    },
    "goods": [
      {
        "goodsBrand": "Antom Brand",
        "goodsCategory": "outdoor goods/bag",
        "goodsImageUrl": "https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*H8M9RrxlArAAAAAAAAAAAAAAAQAAAQ",
        "goodsName": "Classic Woman Bag",
        "goodsQuantity": "1",
        "goodsSkuName": "Black",
        "goodsUnitAmount": {
          "currency": "SGD",
          "value": "6000"
        },
        "goodsUrl": "https://yourGoodsUrl",
        "referenceGoodsId": "yourGoodsId"
      }
    ],
    "orderAmount": {
      "currency": "SGD",
      "value": "6000"
    },
    "orderDescription": "antom ckp testing order",
    "referenceOrderId": "c3df9b82-ff67-424b-880b-06c3615b46ea"
  },
  "paymentAmount": {
    "currency": "SGD",
    "value": "6000"
  },
  "paymentNotifyUrl": "http://www.yourNotifyUrl.com/payment/receiveNotify",
  "paymentRedirectUrl": "http://localhost:8080/index.html?paymentRequestId=597795b7-c812-4132-bd7d-c55914eefdcb",
  "paymentRequestId": "597795b7-c812-4132-bd7d-c55914eefdcb",
  "productCode": "CASHIER_PAYMENT",
  "productScene": "CHECKOUT_PAYMENT"
}

以下代码展示了一个响应的示例，其中包含以下参数：

paymentSessionData：将返回给前端的支付会话数据。
paymentSessionExpiryTime：支付会话的过期时间。
normalUrl: Checkout Page 的跳转链接。

copy
{
    "normalUrl": "https://checkout.antom.com/checkout-page/pages/payment/index.html?sessionData=1iwX2rH5kXnUGT5372d0kHD7PwcgPmRSMgAsvKs8hqRkqobbtWbep59PU2eO5w72h%2B%2XXXX",
    "paymentSessionData": "1iwX2rH5kXnUGT5372d0kHD7PwcgPmRSMgAsvKs8hqRkqobbtWbep59PU2eO5w72h+/c278B+P+nDVNzrQySQQ==&&SG&&188&&eyJleHRlbmRJbmZvIjoie1wiT1BFTl9NVUxUSXXXX",
    "paymentSessionExpiryTime": "2025-03-19T16:21:06+08:00",
    "paymentSessionId": "1iwX2rH5kXnUGT5372d0kHD7PwcgPmRSMgAsvKs8hqSln4WiVZXXXX",
    "result": {
        "resultCode": "SUCCESS",
        "resultMessage": "success.",
        "resultStatus": "S"
    }
}

下表展示了请求报文中 result.resultStatus 字段可能返回的值，请您根据指引进行处理：

*result.resultStatus*	信息	下一步操作
`S`	表示支付会话创建成功。	获取 Antom Checkout Page 链接（normalUrl) 并返回给商户前端。具体操作步骤请参见步骤 2。
`U`	表示由于未知原因支付会话创建失败。	请更换 paymentRequestId 重新调用接口以解决问题。如果问题未解决，请联系 Antom 技术支持。
`F`	表示支付会话创建失败。	请检查并验证当前接口所需的请求字段（包括头部字段和正文字段）是否正确传递并有效。

注意：如果您未收到响应报文，可能是网络超时所致。请更换 paymentRequestId 重新调用接口以解决问题。

步骤 2：跳转至 Antom Checkout Page 客户端

商户服务端获取 normalUrl 后，将该 normalUrl 传递给前端，由商户前端跳转至 Antom Checkout Page 页面。

Web

WAP

iOS

Android

获取 normalUrl 后，您需要在浏览器将页面重定向至 Antom Checkout Page 页面，或在新标签页打开。

copy
if (serverResponse.normalUrl != null) {
    window.open(serverResponse.normalUrl, '_blank');
}

下图为跳转的 Antom Checkout Page 渲染页面：

步骤 3：异步通知处理服务端

1. 设置接收通知的 webhook URL

您可以选择以下两种方法中的一种来设置接受通知的 webhook URL：

若您的每个订单都有单独的通知 URL，建议您在每笔请求中设置 webhook URL。您可以通过 支付会话创建（收银台）接口请求的 paymentNotifyUrl 字段传入该笔订单的接收异步通知 URL。
若您的所有订单都有一个统一的通知 URL，您则可以在 Antom Dashboard > 开发者 > 通知地址 中设置 webhook URL。具体操作请参见通知地址。

APM 支付

卡支付

APM 支付

当支付成功或失败时，Antom 会向您在 支付会话创建（收银台）接口的 paymentNotifyUrl 参数中指定的地址发送异步通知（支付通知）。收到 Antom 的通知后，您需要按照返回收到确认信息返回响应。

Antom 允许您在 支付会话创建（收银台）接口的 paymentNotifyUrl 参数中指定链接。如果每个支付的地址相同，也可以在 Antom Dashboard 中配置该地址。

以下代码展示了通知请求的示例：

paymentRequestId：用于咨询、取消和对账的支付请求 ID。
paymentId：表示由 Antom 生成的支付订单 ID，用于退款和对账。
paymentAmount：表示支付金额。
paymentMethodType：表示买家使用的支付方式。

copy
{
  "actualPaymentAmount": {
    "currency": "KRW",
    "value": "100"
  },
  "notifyType": "PAYMENT_RESULT",
  "paymentAmount": {
    "currency": "KRW",
    "value": "100"
  },
  "paymentCreateTime": "2024-04-19T01:10:49-07:00",
  "paymentId": "20240419194010800100188350218317930",
  "paymentRequestId": "amsdmpay_yuqian_fyf_0b3bd5e9-14bd-4cea-b288-091d9c6862ed",
  "paymentResultInfo": {},
  "paymentTime": "2024-04-19T01:12:14-07:00",
  "pspCustomerInfo": {
    "pspCustomerId": "a070c0d1b89af442c6aa01886f0183de812a5d3d4fe15c771145b2b844a9dd67",
    "pspName": "TOSSPAY"
  },
  "paymentMethodType": "TOSSPAY",
  "result": {
    "resultCode": "SUCCESS",
    "resultMessage": "success.",
    "resultStatus": "S"
  }
}

您可能会收到请求报文中 result.resultStatus 字段的不同值，请您根据下表指引进行处理：

*result.resultStatus*	信息	下一步操作
`S`	表示支付成功。	您可推进订单状态。
`F`	表示支付失败。	请您引导买家重新下单。

常见问题
问：何时会发送通知？
答：不同场景异步通知的发送时间不同。
如果支付成功，Antom 通常会在 3 到 5 秒内发送异步通知。对于某些支付方式，如柜台支付（OTC），通知可能会稍有延迟。
如果买家未提交支付，在支付会话超时时， Antom 不会发送异步通知。
如果买家提交了支付但最终支付未完成：
最后一次提交支付的支付单关单时，若支付会话仍在有效期，Antom 会在支付会话过期时发送异步通知。
最后一次提交支付的支付单关单时，若支付会话已过期，Antom 会在最后一次支付单关单时发送异步通知。
注意：支付会话默认有效期为 1 小时，不同支付方式关闭订单所需时间会有所不同，通常默认为 14 分钟。
问：异步通知会被重新发送吗？
答：是的，对于以下情况，异步通知会在 24 小时内自动重新发送：
由于网络原因未收到异步通知。
您收到来自 Antom 的异步通知后，没有按照处理通知的示例代码格式对通知做出响应。
通知至多重发 8 次或直至收到正确响应终止发送。发送间隔如下：0 分钟，2 分钟，10 分钟，10 分钟，1 小时，2 小时，6 小时，15 小时。
问：在通知中需要使用哪些关键参数？
答：通知中存在以下关键参数：
result：代表订单的支付结果。
paymentRequestId：商户生成的支付请求号，用于查询、撤销、对账。
paymentId：Antom 生成的支付单号，用于退款、对账。
paymentAmount：如有金额核对的需求，可以消费这个字段。
paymentMethodType：表示买家使用的支付方式。
问：有两个异步通知类型，应该用哪一个作为发货的依据？
答：当您收到 notifyType 为 PAYMENT_RESULT 类型的通知时，需要优先判断 paymentMethodType 是否为 CARD，若不为 CARD，则可根据该通知结果选择是否发货。如果为 CARD，需要等待 CAPTURE_RESULT 类型通知，再决策是否发货。

2. 异步通知验签

若您收到 Antom 的异步通知，需要您在返回中按照示例代码格式返回响应，但无需做加签处理。

您需要对 Antom 发送的支付通知进行验签。

copy
/**
 * receive notify
 *
 * @param request    request
 * @param notifyBody notify body
 * @return Result
 */
@PostMapping("/receiveNotify")
@ResponseBody
public Result receiveNotify(HttpServletRequest request, @RequestBody String notifyBody) {
    // retrieve the required parameters from http request
    String requestUri = request.getRequestURI();
    String requestMethod = request.getMethod();
    // retrieve the required parameters from request header
    String requestTime = request.getHeader("request-time");
    String clientId = request.getHeader("client-id");
    String signature = request.getHeader("signature");
    try {
        // verify the signature of notification
        boolean verifyResult = WebhookTool.checkSignature(requestUri, requestMethod, clientId,
                                                          requestTime, signature, notifyBody, ANTOM_PUBLIC_KEY);
        if (!verifyResult) {
            throw new RuntimeException("Invalid notify signature");
        }
        // deserialize the notification body
        JSONObject jsonObject = JSON.parseObject(notifyBody);
        String notifyType = (String)jsonObject.get("notifyType");
        if("PAYMENT_RESULT".equals(notifyType)){
            AlipayPayResultNotify paymentNotify = jsonObject.toJavaObject(AlipayPayResultNotify.class);
            if (paymentNotify != null && "SUCCESS".equals(paymentNotify.getResult().getResultCode())) {
                // handle your own business logic.
                // e.g. The relationship between payment information and users is kept in the database.
                System.out.println("receive payment notify: " + JSON.toJSONString(paymentNotify));
                return Result.builder().resultCode("SUCCESS").resultMessage("success.").resultStatus(ResultStatusType.S).build();
            }
        }else if("CAPTURE_RESULT".equals(notifyType)){
            AlipayCaptureResultNotify captureNotify = jsonObject.toJavaObject(AlipayCaptureResultNotify.class);
            if (captureNotify != null && "SUCCESS".equals(captureNotify.getResult().getResultCode())) {
                // handle your own business logic.
                System.out.println("receive capture notify: " + JSON.toJSONString(captureNotify));
                return Result.builder().resultCode("SUCCESS").resultMessage("success.").resultStatus(ResultStatusType.S).build();
            }
        }
    } catch (Exception e) {
        // handle error condition
        return Result.builder().resultCode("FAIL").resultMessage("fail.").resultStatus(ResultStatusType.F).build();
    }
    return Result.builder().resultCode("SYSTEM_ERROR").resultMessage("system error.").resultStatus(ResultStatusType.F).build();
}

您无需对响应通知结果做加签处理，但是对于每个通知请求均需按以下固定格式响应，与订单支付成功与否无关。

copy
{
    "result": {
        "resultCode": "SUCCESS",
        "resultStatus": "S",
        "resultMessage": "success"
    }
}

支付后操作

查询交易

除了可以通过异步通知的功能获取买家的支付结果，同时也支持您通过主动查询服务来获取对应的结果。您可以调用 支付结果查询 接口，可使用支付会话中的 paymentRequestId 查询支付状态。

以下代码展示了如何调用 支付结果查询 接口：

copy
public static void inquiryPayment() {
    AlipayPayQueryRequest alipayPayQueryRequest = new AlipayPayQueryRequest();
    // replace with your paymentRequestId
    alipayPayQueryRequest.setPaymentRequestId("yourPaymentRequestId");
    AlipayPayQueryResponse alipayPayQueryResponse = null;
    try {
        alipayPayQueryResponse = CLIENT.execute(alipayPayQueryRequest);
    } catch (AlipayApiException e) {
        String errorMsg = e.getMessage();
        // handle error condition
    }
}

以下代码展示了一个响应报文的示例：

copy
{
    "actualPaymentAmount": {
        "currency": "USD",
        "value": "1"
    },
    "customsDeclarationAmount": {
        "currency": "CNY",
        "value": "7"
    },
    "paymentAmount": {
        "currency": "USD",
        "value": "1"
    },
    "paymentId": "20250305194010800100188690281017336",
    "paymentMethodType": "ALIPAY_CN",
    "paymentRedirectUrl": "https://checkout.antom.com/checkout-page/pages/payment/index.html?sessionData=%2BCUim8L0KviXagaygm9xBL5jZ%2F75w6gAX1nn8pcuFuGkIsMoHtD6U88YSyMrMJvorbwnBg5uQv8e6pyvIpjDQQ%3D%3D%26%26SG%26%26188%26%26eyJleHRlbmRJbmZvIjoie1wiT1BFTl9NVUxUSV9QQVlNRU5UX0FCSUxJVFlcIjpcInRydWVcIixcImxvY2FsZVwiOlwiZW5fVVNcIixcImRpc3BsYXlBbnRvbUxvZ29cIjpcInRydWVcIn0iLCJwYXltZW50U2Vzc2lvbkNvbmZpZyI6eyJwYXltZW50TWV0aG9kQ2F0ZWdvcnlUeXBlIjoiQUxMIiwicHJvZHVjdFNjZW5lIjoiQ0hFQ0tPVVRfUEFZTUVOVCIsInByb2R1Y3RTY2VuZVZlcnNpb24iOiIxLjAifSwic2VjdXJpdHlDb25maWciOnsiYXBwSWQiOiIiLCJhcHBOYW1lIjoiT25lQWNjb3VudCIsImJpelRva2VuIjoiNlRjZGJyMnJGM3JQWXg0aGtWckhxYnZqIiwiZ2F0ZXdheSI6Imh0dHBzOi8vaW1ncy1zZWEuYWxpcGF5LmNvbS9tZ3cuaHRtIiwiaDVnYXRld2F5IjoiaHR0cHM6Ly9vcGVuLXNlYS1nbG9iYWwuYWxpcGF5LmNvbS9hcGkvb3Blbi9yaXNrX2NsaWVudCIsIndvcmtTcGFjZUlkIjoiIn0sInNraXBSZW5kZXJQYXltZW50TWV0aG9kIjpmYWxzZX0%3D",
    "paymentRequestId": "PAYMENT_20250305220039086_AUTO",
    "paymentResultCode": "SUCCESS",
    "paymentResultMessage": "success.",
    "paymentStatus": "SUCCESS",
    "paymentTime": "2025-03-05T06:02:34-08:00",
    "pspCustomerInfo": {
        "pspName": "ALIPAY_CN"
    },
    "result": {
        "resultCode": "SUCCESS",
        "resultMessage": "success.",
        "resultStatus": "S"
    }
}

下表展示了响应报文中 paymentStatus 字段可能的值：

*paymentStatus*	信息
`SUCCESS`	表示支付成功。
`FAIL`	表示支付失败。

注意：在查询交易时，如果买家没有提交订单，就会一致报错 ORDER_NOT_EXIST，提交订单以后才不会报错。

退款

若您需要了解 Antom 的退款规则及如何对成功的交易发起退款，详情请参见退款。

争议

若买家选择使用卡支付方式，会涉及到争议相关的集成，详情请参见争议。

对账

交易完成后，使用 Antom 提供的财务报告进行对账。有关如何对账和 Antom 结算规则的更多信息，请参阅对账。

支付方式特性

卡支付

如果您的支付方式中包含卡支付，支付会话参数中必须传入商户端的买家信息。在 order.buyer 字段中，至少需要提供 referenceBuyerId、buyerPhoneNo 或 buyerEmail 三者中的一项。如果未传入买家信息，买家在选择卡支付方式并提交支付时，页面将出现错误，导致支付流程无法完成。

copy
{
    "order": {
        ...
        "buyer": {
            "referenceBuyerId": "88888888",
            "buyerEmail": "gaga@test.com",
            "buyerPhoneNo": "18888888888"
        }
    },
...
}

启用 3D Secure2

若您想了解有关 3D Secure2 的详细信息，请参阅 3D Secure2 验证。

如果您已经具备风控能力，或已经接入了第三方风控服务：您可以根据自身的风险评估，通过 支付会话创建（收银台）接口指定字段 availablePaymentMethod.paymentMethodMetaData.is3DSAuthentication 的值为 TRUE。
如果您还没有风险控制能力：您可以联系 Antom 业务团队启用 Antom 盗卡风险服务。在服务中，Antom 的风控模型将帮助您决策交易是否需要 3DS 安全验证。在此场景下您不需要设置 availablePaymentMethod.paymentMethodMetaData.is3DSAuthentication 的值。

copy
{
  ...
    "availablePaymentMethod": {
        "paymentMethodMetaData": {
            "is3DSAuthentication": true
        }
    },  
  ...
}

当交易通过 3DS 认证后，会在异步通知中增加对应的 3DS 信息，见 paymentResultInfo.threeDSResult 字段。

copy
{
    "actualPaymentAmount": {
        "currency": "HKD",
        "value": "10"
    },
    "notifyType": "PAYMENT_RESULT",
    "paymentAmount": {
        "currency": "HKD",
        "value": "10"
    },
    "paymentCreateTime": "2025-03-01T02:58:03-08:00",
    "paymentId": "20250301194010800100188350280757901",
    "paymentMethodType": "CARD",
    "paymentRequestId": "PAYMENT_20250301185416669_AUTO",
    "paymentResultInfo": {
        "avsResultRaw": "I",
        "cardBrand": "VISA",
        "cardCategory": "CONSUMER",
        "cardNo": "************0197",
        "cardToken": "ALIPAYEfG2DFbGx2Eh739qU+VMnCPEe7MfRKfMfC5k7k/IFASWpAh/vCxHV3dPYpbkGz1iyWCloE4MwfmN48sP8+rSPQ==",
        "cvvResultRaw": "",
        "funding": "CREDIT",
        "issuingCountry": "HK",
        "networkTransactionId": "585060394953881",
        "paymentMethodRegion": "GLOBAL",
        "threeDSResult": {
            "cavv": "AJkBAyh5UQAAAAAKNEBgdQAAAAA=",
            "eci": "05",
            "threeDSVersion": "2.2.0"
        }
    },
    "paymentTime": "2025-03-01T02:58:19-08:00",
    "result": {
        "resultCode": "SUCCESS",
        "resultMessage": "success.",
        "resultStatus": "S"
    }
}

APM 支付

Przelewy24

当买家选择 Przelewy24 支付时，可通过以下方式优化邮箱输入体验：

您可以在支付会话接口中传入availablePaymentMethod.paymentMethodMetaData.payerEmail 参数, Antom Checkout Page 将自动在支付选项中预填充该邮箱，无需您手动输入。

支付会话接口传入 payerEmail 字段

支付会话传接口未传入 payerEmail 字段

示例代码：

copy
{
  ...
    "availablePaymentMethod": {
        "paymentMethodMetaData": {
            "payerEmail": "123221321@test.com",
        }
    },  
  ...
}

买家在选择 Przelewy24 支付时，会预填充邮箱地址：

全托管模式

Mercado Pago

当买家选择 Mercado Pago 支付时，可通过以下方式优化输入体验：

您可以在支付会话接口中传入availablePaymentMethod.paymentMethodMetaData.payerEmail 参数, Antom Checkout Page 将自动在支付选项中预填充该邮箱，无需您手动输入。
您也可以在支付会话接口中传入availablePaymentMethod.paymentMethodMetaData.cpf 参数, Antom Checkout Page 将自动在支付选项中预填充巴西税号，无需您手动输入。

支付会话接口传入 payerEmail 字段

支付会话传接口传入 payerEmail 和 CPF 字段

支付会话传接口未传入 payerEmail 字段

示例代码：

copy
{
  ...
    "availablePaymentMethod": {
        "paymentMethodMetaData": {
            "payerEmail": "123221321@test.com",
        }
    },  
  ...
}

买家在选择 Mercado Pago 支付时，会预填充邮箱地址：

全托管模式

	接口参数传入
指定并过滤支付方式展示	copy `{ ... "availablePaymentMethod": { "paymentMethodTypeList": [ { "paymentMethodType": "ALIPAY_CN", "expressCheckout": true, "paymentMethodOrder": "0" }, { "paymentMethodType": "TNG", "expressCheckout": false, "paymentMethodOrder": "1" } ] } }`
支付方式排序	copy `{ ... "availablePaymentMethod": { "paymentMethodTypeList": [ { "paymentMethodType": "ALIPAY_CN", "expressCheckout": true, "paymentMethodOrder": "0" }, { "paymentMethodType": "TNG", "expressCheckout": false, "paymentMethodOrder": "1" } ] } }`
极速支付方式展示	copy `{ ... "availablePaymentMethod": { "paymentMethodTypeList": [ { "paymentMethodType": "ALIPAY_CN", "expressCheckout": true, "paymentMethodOrder": "0" }, { "paymentMethodType": "TRUEMONEY", "expressCheckout": false, "paymentMethodOrder": "1" } ] } }`

全托管模式

用户体验

支付流程

支付集成步骤

步骤 1：创建支付会话服务端

1. 安装接口库

2. 初始化请求实例

3. 调用支付会话创建接口

4. 创建支付会话

步骤 2：跳转至 Antom Checkout Page 客户端

步骤 3：异步通知处理服务端

1. 设置接收通知的 webhook URL

APM 支付

卡支付

授权异步通知

请款异步通知

2. 异步通知验签

支付后操作

查询交易

退款

争议

对账

支付方式特性

卡支付

启用 3D Secure2

APM 支付

Przelewy24

Mercado Pago

更多内容

指定支付方式

优势

如何启用

Antom Tokenization

优势

如何启用

全托管模式

用户体验

支付流程

支付集成步骤

步骤 1：创建支付会话 服务端

1. 安装接口库

2. 初始化请求实例

3. 调用支付会话创建接口

4. 创建支付会话

步骤 2：跳转至 Antom Checkout Page 客户端

步骤 3：异步通知处理 服务端

1. 设置接收通知的 webhook URL

APM 支付

2. 异步通知验签

支付后操作

查询交易

退款

争议

对账

支付方式特性

卡支付

启用 3D Secure2

APM 支付

Przelewy24

Mercado Pago

更多内容

指定支付方式

优势

如何启用

Antom Tokenization

优势

如何启用

步骤 1：创建支付会话服务端

步骤 3：异步通知处理服务端