• Documentation
  • API 参考

步骤 1: 检查网关连接

在发送任何请求之前,请检查与网关的连接。 要进行检查,请通过 Web 浏览器访问以下 URL: https://test.ibanke-commerce.nbg.gr/api/rest/version/1/information。 如果连接尝试成功,网关处理请求,浏览器页面将显示 {"status":"OPERATING"}。

步骤 2: 设置身份验证方法

网关支持两种身份验证方法:SSL 安全套接层 (SSL) 证书和密码。

  • 选择最适合您的业务模型的方法并实施。
如果您使用 SSL 证书作为身份验证方法,请确保每次连接到网关时验证网关的 SSL 证书路径。 如果您不熟悉如何进行验证或如何从网站导出 SSL 证书,请联系网页开发人员。 确保服务器是可信赖的来源。

步骤 3: 创建交易请求

创建请求正文是集成过程的关键步骤。 从面向付款人的表单收集的在您的系统内生成的请求正文字段将以 REST JSON 格式提交给 API URL。 根据交易操作,URL 中使用以下 HTTP 方法之一:

  • 当您希望系统创建一个新的集合时使用 POST。
  • 当您想要添加或修改集合的成员时使用 PUT。
  • GET 用于检索操作。
面向付款人的表单只允许显示需要付款人输入的字段。 “订单 ID”、“交易 ID”、“版本”和“商家 ID”等字段的值必须在您的代码内计算。

为表单中的请求正文数据设置格式

无论代码段中选择哪种语言;集成为交易请求数据设置正确的格式都很重要。 在许多语言中,通常以数组的形式接收付款人输入的表单数据。

在大多数情况下,您可以使用数组存储要传递给网关的每个字段的字段名和值,并按以下片段所示设置格式。 此代码段完成两个关键功能,以生成格式正确的交易请求正文:

  • 确保交易请求正文中没有添加空字段。
  • 根据 JSON 协议设置数据格式。

如何将表单数据转换为

(, )  更改
此代码段显示如何将表单数据转换为 。

步骤 4: 发送交易请求

请按照以下步骤确保交易请求正文安全地发送到支付网关:

设置身份验证数据

API 需要每个交易请求都成功通过身份验证。 如果您使用 API 密码作为身份验证方法,以下代码段介绍了如何在每个交易请求中作为标头提供身份验证数据(如商家 ID 或 API 密码,或二者同时提供)。

如果您使用 SSL 证书身份验证,请不要包含身份验证标头。

设置 HTTP 标头

HTTP 标头提供有关发送到网关的交易请求的元数据信息。 除了前面部分介绍的身份验证标头外,以下代码段还演示了如何为每个交易请求设置强制 HTTP 标头。

Content-Length 和 Content-Type 标头至关重要,因为它们向 Web 服务器指示由 MIME 类型标识的数据字节的数量和类型。

您的请求的字符编码必须包含 ISO-8859-1 或 UTF-8 格式。 网关会拒绝任何无法以所支持的格式表示的字符。 如果未指定,网关默认编码为 ISO-8859-1。 以下是 Content-Type 标头的示例。

Content-Type 标头示例
"Content-Type: application/json; charset=UTF-8"

              

要设置标头,使用以下代码。

虽然 UTF-8 是支持的字符格式,但限制发送到信用卡处理器的任何字段只能使用 ISO-8859-1 字符。 这是因为下游金融系统无法支持所有 UTF-8 字符。

使用特定的 HTTP 方法

对每个交易使用特定的 HTTP 方法(如 POST、PUT 或 GET)很重要。 通过 API 执行的所有基本操作均使用 HTTP、POST 或 PUT 方法,CHECK GATEWAY 和各种检索操作除外:

  • HTTP PUT 方法更新集合的编址成员;如果此成员不存在,将创建新成员。 例如,考虑请求 URI 值为以下值的请求: http://example.com/version/v1/merchant/m1/order/o1/transaction/t1

    在 URI 中,t1 是集合资源 o1 的成员。 如果 t1 存在,则请求修改资源 t1,如果不存在,则创建一个新的成员 t1。

  • HTTP GET 方法检索集合的编址成员的表示。 例如,考虑请求 URI 值为以下值的请求: http://example.com/version/v1/merchant/m1/order/o1/transaction/t1

    此请求检索集合资源 o1 的 t1 成员。

  • HTTP POST 方法创建一个新的集合。 在网关 API 中,它主要用于创建新数据集的操作,如 CREATE SESSION 或 PAYMENT OPTIONS INQUIRY 操作。

以下代码段显示如何使用 HTTP POST 方法。

以下代码段显示如何使用 HTTP PUT 方法。

定义目标 URL

每个交易操作用于发送交易请求的 URL 各不相同。 在下面的代码段中,函数根据您的配置计算 URL,设置版本和商家资源值,最后附加自定义资源列表及其标识符。

这些自定义组件代表订单和交易资源。 有关每个操作的 URL 格式的详细信息,请参阅 API 参考中的各个操作。

设置发送交易的 URL

以下代码段显示如何设置用于发送交易的 URL。

验证网关的 SSL 证书

如果您使用 SSL 证书身份验证方法,验证网关的 SSL 证书。 在发送交易请求时验证 SSL 证书可防止恶意攻击和其他潜在的安全问题。 以下代码段显示如何验证 SSL 证书。

配置代理服务器

在某些网络环境中,可能需要通过代理服务器发送交易请求。 请联系您的网络管理员或 Web 托管服务提供商获取有关您的集成是否需要代理服务器的信息。 以下代码段显示如何设置代理及其身份验证。

将交易发送到网关

向网关发送正确格式的交易请求并等待响应。 以下代码段显示如何向网关发送交易。

On This Page


Resources

下载 插件 词汇表 FAQs

版权 © 2025 <<company>>