建立会话
Hosted Checkout 交易的第一步是使用 INITIATE CHECKOUT 操作向 Mastercard Gateway 发送 API 请求。 请求将在网关中创建结账会话,请求中必须包括:
- 与您要创建的 PAY、AUTHORIZE 或 VERIFY 交易相关的详细信息。
- 关于 Hosted Payment Page 必须如何与付款人交互的信息。
- 完成 Hosted Payment Page 过程的说明。
- 要了解此请求支持的所有参数和请求正文字段,请参见 Initiate Checkout。
- 对于 API v62 及更早版本,使用 CREATE CHECKOUT SESSION 操作,而不是 Initiate Checkout。
以下示例显示了 INITIATE CHECKOUT 请求的 cURL 代码段。
| URL | curl --location https://test-anb.mtf.gateway.mastercard.com/api/rest/version/72/merchant/<merchant_ID>/session'\ |
--header 'Content-Type: text/plain' \
--header 'Authorization: Basic <base64-encoded string of "merchant.<merchant ID>:<password>"' \
--data ' {
"apiOperation": "INITIATE_CHECKOUT",
"interaction":{
"operation" :"AUTHORIZE",
"merchant": {
"name": "<merchant_name>"
}
},
"order": {
"currency":"USD",
"amount": "100.00",
"id" : "<order_ID>",
"description": "<description_of_order>"
}
}
'
成功的 INITIATE CHECKOUT 响应包含 session.id 和 successIndicator 字段。 检查 successIndicator 字段值来验证付款是否成功或失败。 详细操作请参见 获取支付结果。