GLODIPAY API 规范

版本 2.0.0

介绍

本文档描述了 GLODIPAY API v2，它支持商户在统一的付款平台上接受信用卡/借记卡、移动银行、二维码、钱包和加密货币。

v2 中的新功能：

多 PSP (支付服务提供商)： 单个结账会话可以同时展示来自多个 PSP 的付款方式。买家可以在托管的结账页面上看到所有可用的付款方式 —— 商户无需额外工作。
自动级联 (S2S)： 启用 is_auto_cascade 后，网关将在返回最终结果之前，自动在多个 PSP 之间重试扣款。
付款链接模式： connectionMode: PAYMENT_LINK 创建一个可共享的 URL，无需重定向 URL。

接口地址 (Endpoints)


测试环境	将另行提供
生产环境	从商户后台的 API Keys 页面获取

签名 (Signature)

所有请求和响应均使用 RSA with MD5 进行签名，以确保完整性和真实性。

生成签名 (商户 -> GLODIPAY)

使用您的 商户私钥（从商户后台获取）对请求 Payload 进行签名。

步骤：

将除 signature 以外的所有请求参数收集为扁平的键值对象。
按 自然升序 对键进行排序（SORT_NATURAL / localeCompare 且 numeric: true）。
修整所有字符串值的前导/尾随空格（递归）。
序列化为 JSON 字符串。
使用 openssl_sign(..., 'md5WithRSAEncryption') 进行签名。
对二进制输出进行 Base64 编码。

验证签名 (GLODIPAY -> 商户)

使用 GLODIPAY 公钥（可在门户网站获取）验证 GLODIPAY 响应和 Webhook。

步骤：

从 Payload 中分离出 signature。
按自然升序对剩余的键进行排序。
修整所有字符串值的前导/尾随空格（递归）。
序列化为 JSON 字符串。
使用 openssl_verify(..., base64_decode($signature), $publicKey, 'md5WithRSAEncryption') 进行验证。
返回值 1 = 有效。

注意 (Node.js)：在排序/序列化之前将所有数字值转换为字符串。转义 JSON 字符串中的正斜杠：.replace(///g, '\/')。

API 规范

POST PAYMENT (结账 V2)

创建结账会话并获取托管付款页面的 URL。托管页面会自动为买家展示所有可用的付款方式。

接口地址: POST /v2/checkout 请求方法: Form Post Content-Type: application/x-www-form-urlencoded (Form Data)

请求参数


merchantId	String(1,50)	M	商户 ID
orderRef	String(1,250)	M	每个商户唯一的交易参考号
amount	Float	M	发票金额。按商户配置最小/最大值
currency	String(3)	M	ISO 4217 货币代码。例如：USD
cancelUrl	String(1,300)	M	(前端) 取消付款时重定向买家的 URL。必须为 https。
callbackUrl	String(1,300)	M	(前端) 付款成功后重定向买家的 URL。必须为 https。
notificationUrl	String(1,300)	M	您的服务器接收 Webhook (IPN) 的接口。必须为 https。
errorUrl	String(1,300)	M	(前端) 发生错误时重定向买家的 URL。必须为 https。
orderDescription	String(max:3000)	M	在结账屏幕上显示的简短描述
metadata	JSON	O	附加到会话的键值对。在 IPN 和查询响应中返回
transactionDocuments	JSON	O	交易的辅助文档
paymentMethod	String	M	要显示的付款方式。请参阅 paymentMethod 取值
paymentFilter	JSON	O	要从会话中排除的付款方式类型
paymentSorter	JSON	O	控制显示顺序的有序付款方式类型数组。有效值：card, paypal, ibanking_push, local_bank_transfer, wire_transfer, wallet, skrill, alipay, wechat, googlepay, applepay, crypto, apm
feeBySeller	Number(0-100)	O	商户支付的手续费百分比。0 = 买家支付 100%。最多保留 2 位小数
billingFirstName	String(max:255)	O	账单名字
billingLastName	String(max:255)	O	账单姓氏
billingStreet1	String(max:255)	O	账单街道地址第 1 行
billingStreet2	String(max:255)	O	账单街道地址第 2 行
billingCity	String(max:255)	O	账单城市
billingEmail	String(max:255)	O	买家电子邮件地址
billingState	String(2,255)	O	账单州/省
billingCountry	String	O	ISO 3166-1 alpha-2 国家代码
billingPostalCode	String(max:25)	O	邮政编码
billingPhoneCountryCode	String(max:10)	O	电话国家代码。例如：美国为 1，印度为 91
billingPhoneNumber	String(max:20)	O	电话号码
brandName	String(1,255)	O	覆盖在托管结账屏幕上显示的品牌名称
colorMode	String(1,255)	O	最多 3 种颜色，用 --- 分隔。接受颜色名称、HEX 或 RGBA。例如：#2e7d32---#e8f5e9---#81c784
logoSource	String(1,255)	O	覆盖在托管结账屏幕上显示的 Logo
customerIp	String	O	客户的 IP 地址
websiteUrl	String(max:300)	O	商户网站 URL
signature	String(max:750)	M	RSA-MD5 签名。请参阅“签名”部分
connectionMode	String	O	DIRECT_POST 或 API
expiresAt	String	O	会话过期时间，ISO 8601 格式，带微秒。例如：2025-09-14T14:03:42.102862Z。默认值：24 小时

M = 必填 (Mandatory)，O = 可选 (Optional)

paymentMethod

指定在托管结账页面上显示哪些付款方式。


ALL	所有可用的付款方式
APM	除银行卡外的所有付款方式
card	信用卡 / 借记卡
googlepay	Google Pay
applepay	Apple Pay
paypal	PayPal
ibanking_push	即时在线银行转账
local_bank_transfer	国内银行转账
wire_transfer	直接电子汇款
wallet	数字钱包
alipay	支付宝
wechat	微信支付
skrill	Skrill
crypto	加密货币

paymentFilter

要从会话中排除的付款方式类型值的 JSON 数组。

["googlepay", "applepay"]

请求示例

{
  "merchantId": "1100000123",
  "orderRef": "ORDER-001",
  "amount": 100.00,
  "currency": "USD",
  "paymentMethod": "card",
  "callbackUrl": "https://yoursite.com/callback",
  "notificationUrl": "https://yoursite.com/webhook",
  "cancelUrl": "https://yoursite.com/cancel",
  "errorUrl": "https://yoursite.com/error",
  "orderDescription": "Test order",
  "billingFirstName": "John",
  "billingLastName": "Doe",
  "billingStreet1": "123 Main St",
  "billingStreet2": "",
  "billingCity": "New York",
  "billingEmail": "john@example.com",
  "billingState": "NY",
  "billingCountry": "US",
  "billingPostalCode": "10001",
  "billingPhoneCountryCode": "1",
  "billingPhoneNumber": "5551234567",
  "brandName": " Client Form Simulate",
  "colorMode": " rgba(224,230,5,1)---rgba(166,233,15,1)---rgba(105,193,28,1)",
  "logoSource": "",
  "customerIp": "1.2.3.4",
  "connectionMode": "API",
  "signature": "base64-encoded-signature"
}

响应 -- connectionMode: API

请求方法: POST Content-Type: application/json


status	String	created
transactionId	String (ULID)	GLODIPAY 交易 ID
paymentLink	String	已签名的 URL —— 将买家重定向到此 URL，以在托管结账页面上完成付款
message	String	人类可读的消息

位于 paymentLink 的托管结账页面会自动向买家展示所有可用的付款方式（多 PSP 集合）。该页面处理方式选择、费用显示以及向 PSP 的重定向。

成功示例:

{
  "status": " created",
  "transactionId": "01jza90dy6w82dfrrqvadn5vs4",
  "paymentLink": "https://payment.gpayprocessing.com/v2/checkout/show?...",
  "message": "Payment Link created successfully"
}

错误示例:

{
  "status": "error",
  "transactionId": null,
  "paymentLink": null,
  "message": "No active payment service providers found. Please contact support."
}

响应 -- connectionMode: DIRECT_POST

GLODIPAY 将买家的浏览器直接重定向到托管的结账页面。不返回 JSON 响应。

发送到 callbackUrl 的数据

付款后，GLODIPAY 通过 GET 请求将买家重定向到 callbackUrl，并带有一个 payload 查询参数：

GET {callbackUrl}?payload={base64-encoded-json}

解码后的 Payload 字段：


status	String	最终交易状态。请参阅“状态值”部分
transactionId	String	GLODIPAY 交易 ID
ref	String	商户的 orderRef
amount	Float	发票金额
currency	String	货币代码
signature	String	RSA-MD5 签名 —— 使用 GLODIPAY 公钥验证

SERVER TO SERVER -- S2S 卡 V2

直接从您的服务器提交银行卡详情，绕过托管结账页面。支持跨多个 PSP 的自动级联。

接口地址: POST /v2/card/api 请求方法: POST Content-Type: application/json

请求参数

包括来自 POST PAYMENT (结账 V2) 的所有参数，以及以下银行卡和账单字段：


billingFirstName	String(max:255)	M	账单名字
billingLastName	String(max:255)	M	账单姓氏
billingStreet1	String(max:255)	M	账单街道地址第 1 行
billingStreet2	String(max:255)	O	账单街道地址第 2 行
billingCity	String(max:255)	M	账单城市
billingEmail	String(max:255)	M	买家电子邮件地址
billingState	String(min:2, max:255)	C	账单州/省。当 billingCountry 为 US 或 CA 时必填
billingCountry	String	M	ISO 3166-1 alpha-2 国家代码
billingPostalCode	String(max:25)	M	邮政编码
billingPhoneCountryCode	String(max:10)	O	电话国家代码。例如：美国为 1，印度为 91
billingPhoneNumber	String(max:30)	M	电话号码
cardNumber	String(12,19)	M	卡号。例如：4111111111111111
cardMonth	String	M	到期月份。例如：12
cardYear	String	M	到期年份（2 位数字）。例如：30
cardSecurityCode	String(3,4)	M	CVV / CVC
customerIp	String	M	客户的 IP 地址
browserDetails	JSON	C	浏览器指纹。请参阅 browserDetails 对象

M = 必填，O = 可选，C = 条件必填

browserDetails 对象

每个 S2S 卡片请求都必须提供。可以作为 JSON 对象（嵌套）或 JSON 编码的字符串提交。键名使用下表所列的 snake_case；camelCase 也会被自动规范化。


accept_header	String	M	浏览器 Accept 头部。例如：text/html,application/xhtml+xml
screen_width	String	M	屏幕宽度（像素）。例如：1920
screen_height	String	M	屏幕高度（像素）。例如：1080
screen_color_depth	String	M	屏幕颜色深度（位）。例如：24
window_width	String	M	视口宽度（像素）。例如：1440
window_height	String	M	视口高度（像素）。例如：900
language	String	M	浏览器语言。例如：en-US
java_enabled	String	M	是否启用 Java。“true”或“false”
user_agent	String	M	浏览器 User Agent 字符串
time_zone	String	M	相对于 UTC 的时区偏移（小时）。例如：UTC+7 为 7
time_zone_name	String	M	IANA 时区名称。例如：Asia/Shanghai

请求体示例:

{
  "merchantId": "1100000123",
  "orderRef": "ORDER-001",
  "amount": "100.00",
  "currency": "USD",
  "paymentMethod": "card",
  "callbackUrl": "https://yoursite.com/callback",
  "notificationUrl": "https://yoursite.com/webhook",
  "cancelUrl": "https://yoursite.com/cancel",
  "errorUrl": "https://yoursite.com/error",
  "orderDescription": "Test order",
  "billingFirstName": "John",
  "billingLastName": "Doe",
  "billingStreet1": "123 Main St",
  "billingStreet2": "",
  "billingCity": "New York",
  "billingEmail": "john@example.com",
  "billingState": "NY",
  "billingCountry": "US",
  "billingPostalCode": "10001",
  "billingPhoneCountryCode": "1",
  "billingPhoneNumber": "5551234567",
  "cardNumber": "4111111111111111",
  "cardMonth": "12",
  "cardYear": "30",
  "cardSecurityCode": "123",
  "customerIp": "1.2.3.4",
  "browserDetails": {
    "accept_header": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
    "screen_width": "1920",
    "screen_height": "1080",
    "screen_color_depth": "24",
    "window_width": "1440",
    "window_height": "900",
    "language": "en-US",
    "java_enabled": "false",
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
    "time_zone": "7",
    "time_zone_name": "Asia/Shanghai"
  },
  "signature": "base64-encoded-signature"
}

收集 browserDetails 的 JavaScript 片段:

document.addEventListener('DOMContentLoaded', () => {
  const browserDetails = {
    accept_header: "{{ request()->header('Accept', 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8') }}",
    screen_width: window.screen.width.toString(),
    screen_height: window.screen.height.toString(),
    screen_color_depth: window.screen.colorDepth.toString(),
    window_width: String(window.innerWidth || document.documentElement.clientWidth || screen.width),
    window_height: String(window.innerHeight || document.documentElement.clientHeight || screen.height),
    language: navigator.language,
    java_enabled: 'false',
    user_agent: navigator.userAgent,
    time_zone: String(-new Date().getTimezoneOffset() / 60),
    time_zone_name: Intl.DateTimeFormat().resolvedOptions().timeZone
  };

  document.getElementById('browserDetails').value = JSON.stringify(browserDetails, null, 2);
});

响应

Content-Type: application/json

交易完成 (无需 3DS):

{
  "status": " created",
  "data": {
    "transactionId": "01jwz0ty1640apxvmyzqpvc18a",
  },
  "message": "The transaction has been successfully completed."
}

需要 3DS 认证:

{
  "status": "redirect",
  "data": {
    "transactionId": "01jwz0ty1640apxvmyzqpvc18a",
    "url": "https://payment.gpayprocessing.com/card/3ds/01jwz0ty1640apxvmyzqpvc18a"
  },
  "message": "Please redirect the user to complete the payment."
}

将买家重定向到 url 以完成 3DS。验证后，GLODIPAY 处理交易，通过 IPN 将结果发送到 notificationUrl，并将买家重定向到 callbackUrl。

待处理 (Pending):

{
  "status": "pending",
  "data": {
    "transactionId": "01jwz0ty1640apxvmyzqpvc18a",
  },
  "message": "pending"
}

验证错误 (HTTP 422):

{
  "status": "error",
  "message": "Invalid request data.",
  "errors": [
    {
      "field": "billingEmail",
      "message": ["The billing email field is required."]
    },
    {
      "field": "customerIp",
      "message": ["The customer ip field is required."]
    }
  ]
}

错误 (HTTP 400/500):

{
  "status": "error",
  "data": {
    "transactionId": "01jwz0ty1640apxvmyzqpvc18a",
  },
  "message": "No payment provider could process this transaction. Please try again or contact support."
}

自动级联：当商户启用 is_auto_cascade 时，v2 在返回最终响应之前，会按优先级顺序自动在所有活动的 PSP 之间重试扣款。在级联期间，单个 PSP 的失败将被抑制 —— 仅返回并通过 IPN 发送最终结果。

卡 IFRAME V2

创建银行卡 Iframe 会话。GLODIPAY 不会通过服务器到服务器的方式提交银行卡详情，而是返回一个已签名的 URL，用于托管的银行卡输入页面 (Iframe)，商户可以嵌入该页面或重定向到该页面。银行卡数据直接在 GLODIPAY 托管的页面中输入 —— PCI 范围仍由 GLODIPAY 承担。

接口地址: POST /v2/card/iframe 请求方法: POST Content-Type: application/x-www-form-urlencoded (Form Data)

请求参数

与 POST PAYMENT (结账 V2) 相同。不发送银行卡字段 —— 买家在托管的 Iframe 页面上输入银行卡详情。

响应

始终返回 JSON。


status	String	created
transactionId	String (ULID)	GLODIPAY 交易 ID
url	String	已签名的 URL —— 将此 URL 嵌入 Iframe 或重定向买家以完成银行卡输入
message	String	人类可读的消息

成功示例:

{
  "status": "created",
  "transactionId": "01jza90dy6w82dfrrqvadn5vs4",
  "url": "https://payment.gpayprocessing.com/v2/card-iframe/01jza90dy6w82dfrrqvadn5vs4?...",
  "message": "Iframe card created successfully"
}

错误示例:

{
  "status": "error",
  "transactionId": null,
  "paymentLink": null,
  "message": "No active payment service providers found. Please contact support."
}

在买家在托管页面上提交银行卡详情后，交易结果将通过 IPN 发送到 notificationUrl，买家将被重定向到 callbackUrl 或 errorUrl。

交易查询 (TRANSACTION QUERY)

查询交易的当前状态和完整详情。

接口地址: POST /v2/checkout/query 请求方法: POST Content-Type: application/json

请求 (Request)


transactionId	String (ULID)	M	GLODIPAY 交易 ID
signature	String(max:750)	M	RSA-MD5 签名

响应 (Response)

返回与 NOTIFICATION Webhook 相同的 Payload。

通知 (交易 IPN)

当交易达到终端状态时，GLODIPAY 会向您的 notificationUrl 发送 HTTP POST 请求。

请求方法: POST Content-Type: application/json

重试策略: GLODIPAY 可能会重新发送尚未确认交易的 IPN。您的服务器应在收到通知后立即返回 {"returnCode":"100"}。如果您的接口不可用或返回了非预期的响应，GLODIPAY 将尝试重新传送 IPN。

Payload


merchantId	String	M	商户 ID
transactionId	String	M	GLODIPAY 交易 ID (ULID)
transactionNumber	String	M	GLODIPAY 人类可读的交易编号
ref	String	M	商户的 orderRef
currency	String	M	ISO 4217 货币代码
amount	Float	M	发票金额
paidAmount	Float	O	实际向买家收取的金额（包括买家费用）
settlementAmount	Float	O	结算给商户的金额
estimationSettlementAt	ISO 8601 datetime	O	预计结算日期时间。例如：2023-12-16T02:13:37+00:00
fees	JSON	O	费用明细。请参阅 fees 对象
paymentMethodDetails	JSON	O	所使用的付款方式。请参阅 paymentMethodDetails 对象
status	String	M	交易状态。请参阅“状态值”部分
statusCode	Number	M	数字状态码。请参阅“状态码”部分
metadata	JSON	O	原始结账会话中的键值对
transactionDocuments	JSON	O	原始结账会话中的辅助文档
message	String	O	人类可读的状态消息
descriptor	String	O	交易描述符
transactionCreatedAt	ISO 8601 datetime	M	GLODIPAY 系统中的交易创建时间
originalTransactionCreatedAt	ISO 8601 datetime	M	支付渠道侧的交易创建时间
signature	String	M	RSA-MD5 签名 —— 使用 GLODIPAY 公钥验证

fees 对象


buyer	Float	面向买家的费用金额
seller	Float	商户费用金额
rolling	Float	滚动保证金金额
operate	Float	总运营费用（渠道商 + GLODIPAY + 合作伙伴）
estimationRollingReleaseAt	ISO 8601 datetime	预计滚动保证金释放日期时间

paymentMethodDetails 对象


displayName	String	付款方式标签
group	String	付款方式组类型
family	String	付款方式系列类型
type	String	付款方式类型。可用于 paymentMethod / paymentFilter 字段

IPN Payload 示例:

{
  "merchantId": "1100000123",
  "transactionId": "01jza90dy6w82dfrrqvadn5vs4",
  "transactionNumber": "2604-1713100800",
  "ref": "ORDER-001",
  "currency": "USD",
  "amount": 100.00,
  "paidAmount": 105.00,
  "settlementAmount": 95.00,
  "estimationSettlementAt": "2026-04-16T00:00:00+00:00",
  "fees": {
    "buyer": 5.00,
    "seller": 5.00,
    "rolling": 2.00,
    "operate": 3.00,
    "estimationRollingReleaseAt": "2026-05-14T00:00:00+00:00"
  },
  "status": "successful",
  "statusCode": 6,
  "paymentMethodDetails": {
    "displayName": "Credit / Debit Card",
    "group": "card",
    "family": "card",
    "type": "card"
  },
  "metadata": { "orderId": "12345" },
  "transactionCreatedAt": "2026-04-14T10:00:00+00:00",
  "originalTransactionCreatedAt": "2026-04-14T10:00:01+00:00",
  "signature": "base64-encoded-rsa-signature"
}

响应 (商户 -> GLODIPAY)

您的服务器必须在 30 秒 内响应：

{
  "returnCode": "100",
  "description": "Received"
}


returnCode	String	R	必须为 "100" 以确认收到
description	String(1,1500)	O	可选描述

退款 API

为已完成的交易发起退款。

接口地址: POST /v2/refund 请求方法: POST Content-Type: application/json

请求 (Request)


transactionId	String (ULID)	M	从结账 IPN 接收到的 transactionId
amount	Float	M	退款金额。最小值：0.10（某些渠道可能要求全额退款）。最大值：剩余可退款金额（paidAmount - 已退款金额）
reason	String(max:1000)	O	退款原因的简短描述
signature	String(max:750)	M	RSA-MD5 签名

注意：某些支付渠道（如 PayAgency, SmartPay, ClisaPay, FinvyPay, WPay）仅支持全额退款。系统将相应地强制执行最小退款金额。

响应 (Response)

Content-Type: application/json

退款已创建并立即处理（启用了自动退款）：

{
  "status": "success",
  "message": null,
  "data": {
    "refundId": "01jzabk09xc4pbgwe8hyg4cwbf",
    "refundNumber": "2507-1751420414"
  }
}

退款已创建并等待人工审核：

{
  "status": "success",
  "message": "Refund created and waiting for approval.",
  "data": {
    "refundId": "01jzabk09xc4pbgwe8hyg4cwbf",
    "refundNumber": "2507-1751420414"
  }
}

验证错误 (HTTP 422):

{
  "status": "error",
  "message": "Invalid request data.",
  "errors": [
    {
      "field": "amount",
      "message": ["The amount must be between 0.1 and 100."]
    }
  ]
}

退款查询

查询退款的最新状态。

接口地址: POST /v2/refund/query 请求方法: POST Content-Type: application/json

请求 (Request)


refundId	String (ULID)	M	GLODIPAY 退款 ID（来自退款 API 响应或退款 IPN）
signature	String(max:750)	M	RSA-MD5 签名

响应 (Response)

Content-Type: application/json


status	String	success
message	String	人类可读的消息
data	JSON	退款详情。字段与 REFUND NOTIFICATION Payload 相同

示例:

{
  "status": "success",
  "message": "",
  "data": {
    "transactionId": "01jza90dy6w82dfrrqvadn5vs4",
    "ref": "ORDER-001",
    "refundId": "01jzabk09xc4pbgwe8hyg4cwbf",
    "currency": "USD",
    "refundAmount": 50.00,
    "status": "refund_successful",
    "statusCode": 11,
    "reason": "Customer request",
    "originalRefundCreatedAt": "2026-04-14T11:00:00+00:00",
    "refundCreatedAt": "2026-04-14T11:00:01+00:00",
    "transactionCreatedAt": "2026-04-14T10:00:00+00:00",
    "signature": "base64-encoded-rsa-signature"
  }
}

退款通知 (退款 IPN)

当退款状态发生变化时，GLODIPAY 会向您的 notificationUrl 发送 HTTP POST 请求。

请求方法: POST Content-Type: application/json

Payload


transactionId	String	M	GLODIPAY 原始交易 ID
ref	String	M	商户的 orderRef
refundId	String	M	GLODIPAY 退款 ID
currency	String	M	ISO 4217 货币代码
refundAmount	Float	M	退款金额
status	String	M	退款状态。请参阅“状态值”部分
statusCode	Number	M	数字状态码。请参阅“状态码”部分
metadata	JSON	O	原始结账会话中的键值对
reason	String	O	退款原因
message	String	O	人类可读的状态消息
originalRefundCreatedAt	ISO 8601 datetime	M	支付渠道侧的退款创建时间
refundCreatedAt	ISO 8601 datetime	M	GLODIPAY 系统中的退款创建时间
transactionCreatedAt	ISO 8601 datetime	M	原始交易创建时间
signature	String	M	RSA-MD5 签名 —— 使用 GLODIPAY 公钥验证

响应 (商户 -> GLODIPAY)

{
  "returnCode": "100",
  "description": "Received"
}

模拟付款 (测试卡)

使用测试环境。不产生实际费用。


无 3DS	`4111 1111 1111 1111`	01/30	029	—
无 3DS	`5555 5555 5555 4444`	01/30	029	—
3DS 付款	`4012 8888 8888 1881`	01/30	029	成功：123456 / 失败：111111
3DS 付款	`5111 1111 1111 1118`	01/30	029	成功：123456 / 失败：111111
3DS 付款	`4141 4141 4141 4141`	12/30	123	成功：123456 / 失败：111111

附录

付款方式


card	信用卡或借记卡
googlepay	Google Pay
applepay	Apple Pay
paypal	PayPal
ibanking_push	即时在线银行转账
local_bank_transfer	国内银行转账
wire_transfer	直接电子汇款
wallet	数字钱包
alipay	支付宝
wechat	微信支付
skrill	Skrill
crypto	加密货币
APM	除银行卡外的所有付款方式
ALL	所有可用的付款方式

连接模式


DIRECT_POST	(默认) 浏览器立即重定向到托管的结账页面。
API	在 JSON 响应中返回 paymentLink URL。

状态值

在 IPN Payload 和查询响应的 status 字段中返回的字符串值。


incomplete	交易已发起，等待操作
pending	等待付款确认
under_review	交易审核中
successful	付款成功完成
failed	付款失败
error	发生系统错误
canceled	交易已取消
rejected	交易被拒绝
expired	交易已过期
released	资金已释放 / 结算
documents_uploaded	辅助文档已上传
refund_initiated	退款请求已发起
refund_under_review	退款审核中
refund_successful	退款成功完成
refund_failed	退款失败
refund_partially_successful	部分退款完成
refund_partially_failed	部分退款失败
void_initiated	撤销已发起
void_under_review	撤销审核中
void_successful	撤销成功完成
void_failed	撤销失败
void_partially_successful	部分撤销完成
void_partially_failed	部分撤销失败
chargeback_alert	收到拒付警报
chargebacked	交易已拒付
dispute	争议已开启

状态码

在 IPN Payload 和查询响应的 statusCode 字段中的数字代码。


1	incomplete	交易已发起
2	pending	等待确认
3	error	系统错误
4	failed	付款失败
5	under_review	审核中
6	successful	付款成功
7	released	已释放 / 结算
8	refund_initiated	退款已发起
9	refund_failed	退款失败
10	refund_under_review	退款审核中
11	refund_successful	退款成功
12	refund_partially_failed	部分退款失败
13	refund_partially_successful	部分退款成功
14	canceled	已取消
15	rejected	已拒绝
16	expired	已过期
17	documents_uploaded	文档已上传
18	void_initiated	撤销已发起
19	void_under_review	撤销审核中
20	void_successful	撤销成功
21	void_failed	撤销失败
22	void_partially_successful	部分撤销成功
23	void_partially_failed	部分撤销失败
24	chargeback_alert	拒付警报
25	chargebacked	已拒付
26	dispute	争议已开启

货币代码

GLODIPAY 遵循 ISO 4217 标准。

结账 API (/v2/checkout) 和 卡 Iframe API (/v2/card/iframe)：仅接受 USD。
服务器到服务器卡 API (/v2/card/api)：接受的货币取决于支付渠道。常用的支持值包括：


USD	美元
EUR	欧元
GBP	英镑
AUD	澳元
AED	阿联酋迪拉姆
VND	越南盾

国家代码

GLODIPAY 在 billingCountry 字段中使用 ISO 3166-1 alpha-2 两位字母代码。


AD	安道尔
AE	阿拉伯联合酋长国
AF	阿富汗
AG	安提瓜和巴布达
AI	安圭拉
AL	阿尔巴尼亚
AM	亚美尼亚
AO	安哥拉
AQ	南极洲
AR	阿根廷
AS	美属萨摩亚
AT	奥地利
AU	澳大利亚
AW	阿鲁巴
AX	奥兰群岛
AZ	阿塞拜疆
BA	波斯尼亚和黑塞哥维那
BB	巴巴多斯
BD	孟加拉国
BE	比利时
BF	布基纳法索
BG	保加利亚
BH	巴林
BI	布隆迪
BJ	贝宁
BL	圣巴泰勒米
BM	百慕大
BN	文莱达鲁萨兰国
BO	多民族玻利维亚国
BQ	博内尔、圣尤斯特歇斯和萨巴
BR	巴西
BS	巴哈马
BT	不丹
BV	布韦岛
BW	博茨瓦纳
BY	白俄罗斯
BZ	伯利兹
CA	加拿大
CC	科科斯（基林）群岛
CD	刚果民主共和国
CF	中非共和国
CG	刚果
CH	瑞士
CI	科特迪瓦
CK	库克群岛
CL	智利
CM	喀麦隆
CN	中国
CO	哥伦比亚
CR	哥斯达黎加
CU	古巴
CV	佛得角
CW	库拉索
CX	圣诞岛
CY	塞浦路斯
CZ	捷克
DE	德国
DJ	吉布提
DK	丹麦
DM	多米尼克
DO	多米尼加共和国
DZ	阿尔及利亚
EC	厄瓜多尔
EE	爱沙尼亚
EG	埃及
EH	西撒哈拉
ER	厄立特里亚
ES	西班牙
ET	埃塞俄比亚
FI	芬兰
FJ	斐济
FK	福克兰群岛（马尔维纳斯）
FM	密克罗尼西亚联邦
FO	法罗群岛
FR	法国
GA	加蓬
GB	大不列颠及北爱尔兰联合王国
GD	格林纳达
GE	格鲁吉亚
GF	法属圭亚那
GG	根西岛
GH	加纳
GI	直布罗陀
GL	格陵兰
GM	冈比亚
GN	几内亚
GP	瓜德罗普
GQ	赤道几内亚
GR	希腊
GS	南乔治亚岛和南桑威奇群岛
GT	危地马拉
GU	关岛
GW	几内亚比绍
GY	圭亚那
HK	香港
HM	赫德岛和麦克唐纳群岛
HN	洪都拉斯
HR	克罗地亚
HT	海地
HU	匈牙利
ID	印度尼西亚
IE	爱尔兰
IL	以色列
IM	马恩岛
IN	印度
IO	英属印度洋领地
IQ	伊拉克
IR	伊朗伊斯兰共和国
IS	冰岛
IT	意大利
JE	泽西岛
JM	牙买加
JO	约旦
JP	日本
KE	肯尼亚
KG	吉尔吉斯斯坦
KH	柬埔寨
KI	基里巴斯
KM	科摩罗
KN	圣基茨和尼维斯
KP	朝鲜民主主义人民共和国
KR	大韩民国
KW	科威特
KY	开曼群岛
KZ	哈萨克斯坦
LA	老挝人民民主共和国
LB	黎巴嫩
LC	圣卢西亚
LI	列支敦士登
LK	斯里兰卡
LR	利比里亚
LS	莱索托
LT	立陶宛
LU	卢森堡
LV	拉脱维亚
LY	利比亚
MA	摩洛哥
MC	摩纳哥
MD	摩尔多瓦共和国
ME	黑山
MF	圣马丁（法属部分）
MG	马达加斯加
MH	马绍尔群岛
MK	北马其顿
ML	马里
MM	缅甸
MN	蒙古
MO	澳门
MP	北马里亚纳群岛
MQ	马提尼克
MR	毛里塔尼亚
MS	蒙特塞拉特
MT	马耳他
MU	毛里求斯
MV	马尔代夫
MW	马拉维
MX	墨西哥
MY	马来西亚
MZ	莫桑比克
NA	纳米比亚
NC	新喀里多尼亚
NE	尼日尔
NF	诺福克岛
NG	尼日利亚
NI	尼加拉瓜
NL	荷兰王国
NO	挪威
NP	尼泊尔
NR	瑙鲁
NU	纽埃
NZ	新西兰
OM	阿曼
PA	巴拿马
PE	秘鲁
PF	法属波利尼西亚
PG	巴布亚新几内亚
PH	菲律宾
PK	巴基斯坦
PL	波兰
PM	圣皮埃尔和密克隆
PN	皮特凯恩
PR	波多黎各
PS	巴勒斯坦国
PT	葡萄牙
PW	帕劳
PY	巴拉圭
QA	卡塔尔
RE	留尼汪
RO	罗马尼亚
RS	塞尔维亚
RU	俄罗斯联邦
RW	卢旺达
SA	沙特阿拉伯
SB	所罗门群岛
SC	塞舌尔
SD	苏丹
SE	瑞典
SG	新加坡
SH	圣赫勒拿、阿森松和特里斯坦-达库尼亚
SI	斯洛文尼亚
SJ	斯瓦尔巴和扬马延
SK	斯洛伐克
SL	塞拉利昂
SM	圣马力诺
SN	塞内加尔
SO	索马里
SR	苏里南
SS	南苏丹
ST	圣多美和普林西比
SV	萨尔瓦多
SX	荷属圣马丁
SY	阿拉伯叙利亚共和国
SZ	斯威士兰
TC	特克斯和凯科斯群岛
TD	乍得
TF	法属南部领地
TG	多哥
TH	泰国
TJ	塔吉克斯坦
TK	托克劳
TL	东帝汶
TM	土库曼斯坦
TN	突尼斯
TO	汤加
TR	土耳其
TT	特立尼达和多巴哥
TV	图瓦卢
TW	中国台湾
TZ	坦桑尼亚联合共和国
UA	乌克兰
UG	乌干达
UM	美国本土外小岛屿
US	美利坚合众国
UY	乌拉圭
UZ	乌兹别克斯坦
VA	圣座
VC	圣文森特和格林纳丁斯
VE	委内瑞拉玻利瓦尔共和国
VG	维尔京群岛（英属）
VI	维尔京群岛（美属）
VN	越南
VU	瓦努阿图
WF	瓦利斯和富图纳
WS	萨摩亚
YE	也门
YT	马约特
ZA	南非
ZM	赞比亚
ZW	津巴布韦

有关完整的 ISO 3166 列表，请访问 https://www.iso.org/iso-3166-country-codes.html

卡类型


1	VISA	visa
2	MASTERCARD	mastercard
3	AMERICAN EXPRESS	amex
4	JCB	jcb
5	MAESTRO	maestro
6	DISCOVER	discover
7	UNION PAY	union-pay
8	DINERS	diners

代码示例

PHP

<?php

function generateSignature(array $data): string
{
    $privateKey = openssl_pkey_get_private("-----BEGIN PRIVATE KEY-----
YOUR_PRIVATE_KEY_HERE
-----END PRIVATE KEY-----
");

    ksort($data, SORT_NATURAL);
    array_walk_recursive(
        $data,
        static function (&$field) {
            $field = trim($field);
        }
    );

    openssl_sign(json_encode($data), $signature, $privateKey, 'md5WithRSAEncryption');

    return base64_encode($signature);
}

function verifySignature(array $data): bool
{
    $publicKey = openssl_pkey_get_public("-----BEGIN PUBLIC KEY-----
YOUR_GLODIPAY_PUBLIC_KEY_HERE
-----END PUBLIC KEY-----
");

    $dataWithoutSignature = array_filter($data, static function ($key) {
        return $key !== 'signature';
    }, ARRAY_FILTER_USE_KEY);

    $signature = $data['signature'];

    ksort($dataWithoutSignature, SORT_NATURAL);
    array_walk_recursive(
        $dataWithoutSignature,
        static function (&$field) {
            $field = trim($field);
        }
    );

    $result = openssl_verify(
        json_encode($dataWithoutSignature),
        base64_decode($signature),
        $publicKey,
        'md5WithRSAEncryption'
    );

    return $result === 1;
}

// 示例：创建 v2 结账（API 模式）
$payload = [
    'merchantId'       => '1100000123',
    'orderRef'         => 'ORDER-' . time(),
    'amount'           => '100.00',
    'currency'         => 'USD',
    'paymentMethod'    => 'ALL',
    'callbackUrl'      => 'https://yoursite.com/payment/callback',
    'notificationUrl'  => 'https://yoursite.com/payment/webhook',
    'cancelUrl'        => 'https://yoursite.com/payment/cancel',
    'errorUrl'         => 'https://yoursite.com/payment/error',
    'orderDescription' => 'Test order',
    'customerIp'       => $_SERVER['REMOTE_ADDR'],
    'connectionMode'   => 'API',
];

$payload['signature'] = generateSignature($payload);

$ch = curl_init('https://payment-sandbox.gpayprocessing.com/v2/checkout');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($payload));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
// 将买家重定向到 $result['paymentLink']
header('Location: ' . $result['paymentLink']);
exit;

Node.js

// Save as script.mjs and run: node script.mjs
import { createSign, createVerify } from 'crypto';
import https from 'https';
import querystring from 'querystring';

const PRIVATE_KEY = `-----BEGIN PRIVATE KEY-----
YOUR_PRIVATE_KEY_HERE
-----END PRIVATE KEY-----`;

function phpCast(v) {
    if (typeof v === 'number') return String(v);
    if (typeof v === 'boolean') return v ? '1' : '';
    if (typeof v === 'string') return v.trim();
    if (Array.isArray(v)) return v.map(phpCast);
    if (v && typeof v === 'object') return Object.fromEntries(Object.entries(v).map(([k, val]) => [k, phpCast(val)]));
    return v;
}

function generateSignature(data) {
    const sorted = {};
    Object.keys(data)
        .filter(k => k !== 'signature')
        .sort((a, b) => a.localeCompare(b, undefined, { numeric: true, sensitivity: 'base' }))
        .forEach(k => { sorted[k] = data[k]; });

    const canonical = JSON.stringify(phpCast(sorted))
        .replace(/\//g, '\\/')
        .replace(/[\u0080-\uffff]/g, c => '\\u' + c.charCodeAt(0).toString(16).padStart(4, '0'));

    const sign = createSign('md5WithRSAEncryption');
    sign.update(canonical);
    return sign.sign(PRIVATE_KEY, 'base64');
}

function verifySignature(data) {
    const publicKey = `-----BEGIN PUBLIC KEY-----
YOUR_GLODIPAY_PUBLIC_KEY_HERE
-----END PUBLIC KEY-----`;

    const { signature, ...rest } = data;

    const sorted = {};
    Object.keys(rest)
        .sort((a, b) => a.localeCompare(b, undefined, { numeric: true, sensitivity: 'base' }))
        .forEach(k => { sorted[k] = rest[k]; });

    const canonical = JSON.stringify(phpCast(sorted))
        .replace(/\//g, '\\/')
        .replace(/[\u0080-\uffff]/g, c => '\\u' + c.charCodeAt(0).toString(16).padStart(4, '0'));

    const verify = createVerify('md5WithRSAEncryption');
    verify.update(canonical);
    return verify.verify(publicKey, Buffer.from(signature, 'base64'));
}

// 示例：创建 v2 结账（API 模式）
const payload = {
    merchantId: '1100000123',
    orderRef: 'ORDER-' + Date.now(),
    amount: '100.00',
    currency: 'USD',
    paymentMethod: 'ALL',
    callbackUrl: 'https://yoursite.com/payment/callback',
    notificationUrl: 'https://yoursite.com/payment/webhook',
    cancelUrl: 'https://yoursite.com/payment/cancel',
    errorUrl: 'https://yoursite.com/payment/error',
    orderDescription: 'Test order',
    customerIp: '1.2.3.4',
    connectionMode: 'API',
};

payload.signature = generateSignature(payload);

const postData = querystring.stringify(payload);
const options = {
    hostname: 'payment-sandbox.gpayprocessing.com',
    path: '/v2/checkout',
    method: 'POST',
    headers: {
        'Content-Type': 'application/x-www-form-urlencoded',
        'Content-Length': Buffer.byteLength(postData),
    },
};

const req = https.request(options, (res) => {
    let body = '';
    res.on('data', chunk => body += chunk);
    res.on('end', () => {
        const result = JSON.parse(body);
        console.log('Payment Link:', result.paymentLink);
        // 重定向买家: res.writeHead(302, { Location: result.paymentLink });
    });
});

req.on('error', console.error);
req.write(postData);
req.end();

目录​

介绍​

接口地址 (Endpoints)​

签名 (Signature)​

生成签名 (商户 -> GLODIPAY)​

验证签名 (GLODIPAY -> 商户)​

API 规范​

POST PAYMENT (结账 V2)​

请求参数​

paymentMethod​

paymentFilter​

请求示例​

响应 -- connectionMode: API​

响应 -- connectionMode: DIRECT_POST​

发送到 callbackUrl 的数据​

SERVER TO SERVER -- S2S 卡 V2​

请求参数​

browserDetails 对象​

响应​

卡 IFRAME V2​

请求参数​

响应​

交易查询 (TRANSACTION QUERY)​

请求 (Request)​

响应 (Response)​

通知 (交易 IPN)​

Payload​

fees 对象​

paymentMethodDetails 对象​

响应 (商户 -> GLODIPAY)​

退款 API​

请求 (Request)​

响应 (Response)​

退款查询​

请求 (Request)​

响应 (Response)​

退款通知 (退款 IPN)​

Payload​

响应 (商户 -> GLODIPAY)​

模拟付款 (测试卡)​

附录​

付款方式​

连接模式​

状态值​

状态码​

货币代码​

国家代码​

卡类型​

代码示例​

PHP​

Node.js​

Bookmarks

目录

介绍

接口地址 (Endpoints)

签名 (Signature)

生成签名 (商户 -> GLODIPAY)

验证签名 (GLODIPAY -> 商户)

API 规范

POST PAYMENT (结账 V2)

请求参数

paymentMethod

paymentFilter

请求示例

响应 -- connectionMode: API

响应 -- connectionMode: DIRECT_POST

发送到 callbackUrl 的数据

SERVER TO SERVER -- S2S 卡 V2

请求参数

browserDetails 对象

响应

卡 IFRAME V2

请求参数

响应

交易查询 (TRANSACTION QUERY)

请求 (Request)

响应 (Response)

通知 (交易 IPN)

Payload

fees 对象

paymentMethodDetails 对象

响应 (商户 -> GLODIPAY)

退款 API

请求 (Request)

响应 (Response)

退款查询

请求 (Request)

响应 (Response)

退款通知 (退款 IPN)

Payload

响应 (商户 -> GLODIPAY)

模拟付款 (测试卡)

附录

付款方式

连接模式

状态值

状态码

货币代码

国家代码

卡类型

代码示例

PHP

Node.js