createPaymentSession（单笔支付）
入参
userRegion String
基于 ISO 3166 国家代码标准的 2 位国家或地区代码。此参数用于根据用户所在地区来排序电子钱包支付方式。当满足以下条件之一时，请指定此字段：
- 当您需要根据用户的地区对电子钱包支付方式进行排序时。例如，如果您的支付方式列表中同时有
ALIPAY_CN 和KAKAOPAY，而用户来自韩国，则在 Alipay+ 收银页面上，KAKAOPAY 将优先列出。 - 当您需要 Antom 来协助您的外汇资金流入申报时。
注意：
- 此参数仅适用于已集成 Alipay+ 收银页面的商家或需要申报入境资金的商家。
- 当该笔支付需进行结汇入中申报时，此字段为必填项。
更多信息：
- 最大长度：2 字符
merchantRegion String
商户经营业务的国家或地区。该参数遵循 ISO 3166 国家代码标准的二位字母国家或地区代码。
可能的值包括 US, SG, HK, PK, JP, CN, BR, AU, 和 MY。
注意：当使用全球收单网关（GAGW）产品时，此参数是必需的。
更多信息：
- 最大长度：2 字符
env Env
下单的环境信息。
注意：当需要风险控制时指定此参数。提供此信息有助于提高反洗钱和欺诈检测的准确性，以及提高支付成功率。
order Order REQUIRED
包括买家、商户、商品、金额、配送信息和购买环境的订单信息。此字段用于以下目的：
- 在支付过程中，此字段主要用于 Antom 的风险控制或反洗钱。
- 支付完成后，此字段用于记录和报告，如采购追踪和监管报告。
paymentRequestId String REQUIRED
商户为识别支付请求而分配的专属 ID。
更多信息：
- 最大长度：64 字符
paymentAmount Amount REQUIRED
商户请求以订单币种收取的支付金额。
settlementStrategy SettlementStrategy REQUIRED
支付请求的结算策略。
paymentMethod PaymentMethod REQUIRED
商家或收单机构用于收取支付的支付方式。
savedPaymentMethods Object
用户在商户系统中已存储的支付信息。
paymentFactor PaymentFactor
影响支付的因素。此字段用于指示支付场景。
注意：当 paymentMethodType 的值为
CARD并且您集成客户端 SDK 时，指定此参数。
enableInstallmentCollection Boolean
指示是否允许 Antom 收集支付的分期信息。
如果需要 Antom 收集分期信息，请指定此参数。有效值为：
true: 表示当用户的卡支持分期时，Antom 会收集分期信息。如果用户的卡不支持分期，则不提供分期。false: 表示不需要 Antom 收集分期信息。如果值为空或未指定此参数，情况相同。
creditPayPlan CreditPayPlan
此支付的分期付款计划信息。
注意：当支付支持分期且在 paymentMethod.paymentMethodMetaData 中指定了与银行卡相关的信息时，指定此参数。
paymentSessionExpiryTime Datetime
支付会话过期的具体日期和时间。默认过期时间为会话创建后 1 小时。例如，如果会话在 2023-7-27T12:00:01+08:30 创建，那么会话过期时间为 2023-7-27T13:00:01+08:30。
注意：如果希望使用不同于默认时间的支付会话过期时间，请指定此参数。指定的过期时间必须在会话创建后 0 到 1 小时之间。
更多信息：
- 值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。
paymentNotifyUrl URL
用于接收支付结果通知的链接。
注意：如果希望接收支付结果的异步通知，请设置此参数。您也可以在 Antom Dashboard 中设置接收结果通知的链接。如果请求和 Antom Dashboard 中都指定了链接，则请求中指定的值优先。
更多信息：
- 最大长度：2048 字符
paymentRedirectUrl URL REQUIRED
支付完成后用户被重定向到的商户页面链接。
更多信息：
- 最大长度：2048 字符
productCode String REQUIRED
表示合同中规定的正在使用的支付产品。对于单笔支付，值设置为 CASHIER_PAYMENT。
locale String
收银台指定的语言标签。如果该字段为空或设置为自动，则将使用浏览器的默认语言设置，通常为英文。
更多信息：
- 最大长度：8 字符
出参
result Result REQUIRED
接口调用的结果。
paymentSessionId String REQUIRED
Antom 为识别支付会话而分配的加密 ID。
更多信息：
- 最大长度：64 字符
paymentSessionData String REQUIRED
加密的支付会话数据。将数据传递给前端以初始化 SDK 客户端。
更多信息：
- 最大长度：4096 字符
paymentSessionExpiryTime Datetime REQUIRED
支付会话过期的具体日期和时间。
更多信息：
- 值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。
请求
响应
商品名称规范
在航司 ABA KRW 非机票支付场景下, 传入 order.goods.goodsName 字段时须符合商品名称规范。下表为商品名称规范详情：
更多信息
关于 order 字段：Antom 不会验证 order 字段中的金额与支付请求中的金额是否一致。订单信息也不应用于资金操作。此字段主要用于风险控制、监管、监管报告和消费记录显示。如果需要 Antom 提供的风险控制能力，请使用 env 字段。
结果码
| 结果码 | 值 | 结果码信息 | 行动建议 |
|---|---|---|---|
| SUCCESS | S | 成功 |
支付会话已成功创建。无需进一步操作。 |
| PARAM_ILLEGAL | F | 缺少必需的参数，或者存在非法参数。例如，非数字输入，无效的日期，或者参数的长度和类型错误。 |
检查并验证当前接口所需的请求字段（包括头部字段和正文字段）是否正确传递并有效。 |
| PROCESS_FAIL | F | 发生了常见的业务失败。 | 获取 Antom 技术支持前请勿尝试。 |
| NO_PAY_OPTIONS | F | 没有可用的支付选项。 | 请联系 Antom 技术支持以获取详细原因。 |
| CARD_NOT_SUPPORTED | F | 用于交易的银行卡不被支持。 | 使用另一张银行卡支付交易。 |
| UNKNOWN_EXCEPTION | U | 由于未知原因，接口调用失败。 | 重新调用接口以解决问题。如果问题未解决，请联系 Antom 技术支持。 |