解释响应
一旦付款人完成 <<hostedPaymentPage>> 交互,您需要将他们重定向回您的网站,确定付款结果并向他们出示收据。
步骤 1: 将付款人重定向到您的网站
付款人完成 <<hostedPaymentPage>> 交互后,即会返回到您的网站。 为了实现这一点,您需要通过以下方式之一提供重定向到的 URL:
- 在 Initiate Checkout 操作中提供 interaction.returnUrl 字段。
- 定义 <<hostedPaymentPage>> 的完整回调。 有关详细信息,请参阅 实现回调。
步骤 2: 确定支付结果
网关会通过以下两种方式之一在 resultIndicator 字段中发送付款结果,具体取决于付款人如何重定向回您的网站:
- 附加到用于将付款人返回到您的网站的 URL(interaction.returnUrl)。
- 作为输入参数向 complete 回调中提供的函数提供,或附加到 complete 回调中提供的 URL。
您可以通过将 resultIndicator 参数与 INITIATE CHECKOUT 响应中返回的 successIndicator 参数进行比较来确定付款是否成功。 匹配则表示支付成功。
请勿使用 resultIndicator 参数中的值作为收据号码。
步骤 3: 显示付款收据
如果操作成功,则在您的网站上向付款人显示付款收据,并使用付款详细信息更新您的系统。 您可以通过多种方式检索付款详情:
- 通过 API 请求 - 使用 Retrieve Order 操作。
- 从 Merchant Administration - 付款详细信息在订单和交易详细信息页面的 Merchant Administration 中记录。 您可以搜索该笔付款并进行后续操作。
- 使用 <<reportingAPI>> - 如果您的商家配置文件启用了 <<reportingAPI>> 功能,您可以从网关通过设定格式的报告下载付款数据。
- 来自电子邮件或 Webhook 通知 - 如果您订阅 Merchant Administration中的通知,则每次成功付款时您都会收到一封电子邮件或 Webhook 通知。
花费一些时间检查 API 参考中每个相关操作的交易响应字段。 所有字段都会提供有价值的信息,您可以将其中一些字段存储在本地,用于会计、对账和追溯目的。 集成越复杂,研究特定的响应代码来识别交易状态的各个方面就越有用。
验证您为交易提供的数据是否与用于处理交易的数据相同是一种很好的做法。 例如,检查交易响应中返回的金额是否与您在请求中发送的值相匹配。