Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution

支付会话创建(快捷支付)

POST /v1/payments/createPaymentSession

此接口用于生成客户端 SDK 集成的支付会话。接口响应提供加密的会话数据,可用于初始化 SDK 客户端。这个 SDK 简化了支付流程,使您无需手动调用多个接口。

结构

报文由报文头和报文体组成。本文主要介绍报文体结构信息,有关报文头的结构信息,请参阅:


注意:将每个字段(除数组外)的数据类型设置为字符串。这意味字段值必须使用双引号(" ")括起来。例如:

  • 如果字段的数据类型为整数属性,且其值为 20,设置为 "20"。
  • 如果字段的数据类型为布尔属性,且其值为 true,设置为 "true"。

入参

env Env  

下单的环境信息。

Show child parameters

order Order  REQUIRED

包括买家、商户、商品、金额、配送信息和购买环境的订单信息。此字段用于以下目的:

  • 在支付过程中,此字段主要用于 Antom 的风险控制或反洗钱。
  • 支付完成后,此字段用于记录和报告,如采购追踪和监管报告。
Show child parameters

paymentRequestId String  REQUIRED

商户为识别支付请求而分配的专属 ID。

更多信息:

  • 最大长度:64 字符

paymentAmount Amount  REQUIRED

商家请求在订单货币中接收的支付金额。

Show child parameters

settlementStrategy SettlementStrategy  REQUIRED

支付请求的结算策略。

Show child parameters

paymentMethod PaymentMethod  REQUIRED

商家或收单机构用于收取支付的支付方式。

Show child parameters

agreementInfo AgreementInfo  

快捷支付的授权信息。

注意:仅在首次快捷支付时指定此参数以获取访问令牌。

Show child parameters

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  REQUIRED

用于接收支付结果通知的链接。

更多信息:

  • 最大长度:2048 字符

paymentRedirectUrl URL  REQUIRED

支付完成后用户被重定向到的商户页面链接。

更多信息:

  • 最大长度:2048 字符

productCode String  REQUIRED

表示正在使用的支付产品。值设置为AGREEMENT_PAYMENT

productScene String  REQUIRED

值设置为EASY_PAY,表示快捷支付。  

更多信息:

  • 最大长度:32 字符

出参

result Result  REQUIRED

接口调用的结果。

Show child parameters

paymentSessionId String  REQUIRED

Antom 为识别支付会话而分配的加密 ID。

更多信息:

  • 最大长度:64 字符

paymentSessionData String  REQUIRED

加密的支付会话数据。将数据传递给前端以初始化 SDK 客户端。

更多信息:

  • 最大长度:4096 字符

paymentSessionExpiryTime Datetime  REQUIRED

支付会话的过期日期和时间。 

更多信息:

  • 值遵循 ISO 8601 标准格式。例如,“2019-11-27T12:01:01+08:00”。
API Explorer
示例代码沙箱运行

请求

URL
Case
Payment after a successful authorization
请求体

响应

响应体

更多信息

关于 order 字段:Antom 不会验证 order 字段中的金额与支付请求中的金额是否一致。订单信息也不应用于资金操作。此字段主要用于风险控制、监管、监管报告和消费记录显示。如果需要 Antom 提供的风险控制能力,请使用 env 字段。

order字段例如

结果码

结果码结果码信息行动建议
SUCCESSS成功

支付会话已成功创建。无需进一步操作。

PARAM_ILLEGALF缺少必需的参数,或者存在非法参数。例如,非数字输入,无效的日期,或者参数的长度和类型错误。

检查并验证当前接口所需的请求字段(包括头部字段和正文字段)是否正确传递并有效。

PROCESS_FAILF发生了常见的业务失败。

获取 Antom 技术支持前请勿重试。

UNKNOWN_EXCEPTIONU由于未知原因,接口调用失败。

重新调用接口以解决问题。如果问题未解决,请联系 Antom 技术支持。