- 集成指南
- 实施 <<directPayment>> 集成
实施 <<directPayment>> 集成
先决条件
- 请确保已为 <<webServicesIntegration>> 启用商家配置文件。
- 如果需要,请参见“如何自定义<<directPayment>>解决方案”。
- 在开始集成前,请参见最佳做法和建议。
集成步骤
步骤 1:访问网关
第一步,检查与 QNB ALAHLI 的连接。
步骤 2:了解您的输入字段
在开始构建集成前,您必须为需要您输入的字段准备输入值。
步骤 3:创建交易请求
创建请求主体是商家集成的关键步骤。
步骤 4:发送交易请求
有很多组件可以确保交易请求安全地发送到 QNB ALAHLI。
步骤 5:处理交易响应
当交易请求发送到网关后,您通常会在很短时间内收到响应。您需要处理此响应以完成交易。
步骤 6:测试与投入使用
通过测试,您可以检查您的集成是否如期工作。
疑难解答和常见问题
转到 API 参考索引页“协议文档”部分的相应 (REST/NVP) [所有版本]链接。
是的,所有操作的 API 字段名称均区分大小写。
如果使用 HTTP POST,请在 HTTP 主体中使用 JSON 编码包含请求参数。如果使用 HTTP GET,请确保在 URI 中作为查询参数包含请求参数。
此 QNB ALAHLI<<webServicesIntegration>> 版本不支持商家定义的字段。
重新提交的相同交易将返回与第一次提交相同的响应。此 QNB ALAHLI<<webServicesIntegration>> 版本中的所有操作均是幂等的;换言之,重复执行的相同请求的交易与单个请求相同。因此,您可以放心,不会对您或付款人银行重复执行交易。
从 <<webServicesIntegration>> v15 开始,如果订单的初始交易失败,您可以为此订单提交新的初始交易(具有新交易 ID),无需创建新订单。
自 <<webServicesIntegration>> v15 起,如果您希望对成功的初始交易执行后续的过账或退款交易,则不能在请求中提供卡详细信息。如果在订单已包含成功的初始交易时提供卡详细信息,那么 QNB ALAHLI 将拒绝请求。
如果您未收到响应,建议您等待 60 秒并尝试重新提交相同请求。银行交易不会重复执行,请放心,不会重复转账资金。您将收到与第一个请求收到的响应相同的响应。
所有通过审批的交易均使用来自 QNB ALAHLI 的交易响应代码 APPROVED
表示。任何其他代码均表示被拒或失败的交易。
重新提交的相同交易将返回与第一次提交相同的响应,因为 QNB ALAHLI 中的所有操作都是幂等的(N > 0 个相同请求的附带结果与单个请求相同)。因此,您可以放心,不会对您或付款人银行重复执行交易。
最佳做法和建议
强烈建议无论在何时连接到 QNB ALAHLI 时都要验证 QNB ALAHLI 的 SSL 证书。QNB ALAHLI SSL 证书由行业标准证书认证机构(如 Verisign 或 Thawte)发放,您的网络环境中应该已经存在这些机构的根证书。