GLODIPAY 结账 API 规范

版本 2.0.0

介绍

本文档描述了 GLODIPAY Checkout API v2，它允许商户创建一个托管付款会话，并在一个统一的结账页面中支持信用卡/借记卡、移动银行、二维码、钱包和加密货币。

主要功能：

多 PSP： 单个结账会话可以同时展示来自多个支付服务提供商的付款方式。买家可以在托管页面上看到所有可用选项 —— 商户端无需额外配置。
连接模式： 在浏览器重定向 (DIRECT_POST) 或带有付款链接的 API 响应 (API) 之间进行选择。
自动过期： 会话在 24 小时后自动过期（可通过 expiresAt 配置）。

接口地址 (Endpoints)


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

签名 (Signature)

所有发送给 GLODIPAY 的请求必须包含 signature 字段。所有来自 GLODIPAY 的响应和 IPN Payload 也包含 signature 字段以验证真实性。

签名使用 RSA with MD5 (md5WithRSAEncryption)。

生成签名 (商户 -> GLODIPAY)

使用您的 商户私钥（可从商户后台获取）。

步骤：

将除 signature 以外的所有请求参数收集为扁平的键值对象。
仅按 自然升序 对 顶层键 进行排序（PHP 中的 SORT_NATURAL / JavaScript 中带有 { numeric: true } 的 localeCompare）。不要对嵌套对象（如 fees、paymentMethodDetails）内部的键进行排序。
递归修整所有字符串值的空格。
序列化为 JSON 字符串。
使用 openssl_sign(..., 'md5WithRSAEncryption') 进行签名。
对二进制输出进行 Base64 编码。

验证签名 (GLODIPAY -> 商户)

使用 GLODIPAY 公钥（可在门户网站获取）。

步骤：

从 Payload 中移除 signature。
仅按自然升序对 顶层键 进行排序。不要对嵌套对象内部的键进行排序。
递归修整所有字符串值的空格。
序列化为 JSON 字符串。
使用 openssl_verify(..., base64_decode($signature), $publicKey, 'md5WithRSAEncryption') 进行验证。
返回值 1 = 有效。

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

POST PAYMENT

创建结账会话并重定向（或返回链接）到托管付款页面。

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

请求参数


merchantId	String(1,50)	M	商户 ID
orderRef	String(1,250)	M	每个商户唯一的交易参考号
amount	Float	M	发票金额。最小值：1。最多 2 位小数
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	您的服务器接收 IPN Webhook 的接口。必须为 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 = 必填，O = 可选

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": "DIRECT_POST",
  "signature": "base64-encoded-signature"
}

响应 -- connectionMode: API

Content-Type: application/json


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

成功示例:

{
  "status": " created",
  "transactionId": "01jza90dy6w82dfrrqvadn5vs4",
  "paymentLink": "https://payment.gpayprocessing.com/v2/checkout/01jza90dy6w82dfrrqvadn5vs4?...",
  "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 公钥验证

交易查询 (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)

Content-Type: application/json


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

通知 (NOTIFICATION)

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

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

重试策略: GLODIPAY 可能会重新发送尚未确认交易的 IPN。您的服务器应在收到通知后立即返回 {"returnCode":"100"}。

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	预计结算日期时间
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	付款方式类型
`{type}`	JSON	可选。付款方式特定的详细信息。键名等于 `type` 的值（如 `card`）。仅在银行卡详细信息可用时出现在银行卡付款中。请参阅下面的 card 对象。

card 对象 (`paymentMethodDetails.card`)


name	持卡人姓名
firstSixDigits	卡号前 6 位 (BIN)
lastFourDigits	卡号后 4 位
expiryMonth	过期月份 (MM)
expiryYear	过期年份 (YY)
type	银行卡品牌 (`visa`, `mastercard`, `amex` 等)
issuer	发卡行名称 (取决于渠道)
issuerCountryCode	发卡行国家代码 (ISO 3166-1 alpha-2) (取决于渠道)
funding	银行卡资金类型 (`credit`, `debit`, `prepaid`) (取决于渠道)
authorizationCode	发卡行授权码 (取决于渠道)
clientIP	付款时的客户 IP 地址 (取决于渠道)
checks	AVS/CVC 验证结果 (取决于渠道)
threeDSecure	3D Secure 认证详细信息 (取决于渠道)

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	可选描述

模拟付款

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


无 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 标准。此接口目前仅接受 USD。


USD	美元

国家代码

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	Ecuador
EE	Estonia
EG	埃及
EH	西撒哈拉
ER	Eritrea
ES	西班牙
ET	Ethiopia
FI	Finland
FJ	Fiji
FK	福克兰群岛
FM	密克罗尼西亚
FO	法罗群岛
FR	法国
GA	Gabon
GB	英国
GD	Grenada
GE	Georgia
GF	法属圭亚那
GG	Guernsey
GH	Ghana
GI	Gibraltar
GL	Greenland
GM	Gambia
GN	Guinea
GP	Guadeloupe
GQ	Equatorial Guinea
GR	希腊
GS	南乔治亚岛和南桑威奇群岛
GT	Guatemala
GU	Guam
GW	Guinea-Bissau
GY	Guyana
HK	香港
HM	赫德岛和麦克唐纳群岛
HN	Honduras
HR	Croatia
HT	Haiti
HU	Hungary
ID	Indonesia
IE	Ireland
IL	Israel
IM	Isle of Man
IN	印度
IO	英属印度洋领地
IQ	Iraq
IR	Iran
IS	Iceland
IT	意大利
JE	Jersey
JM	Jamaica
JO	Jordan
JP	日本
KE	Kenya
KG	Kyrgyzstan
KH	柬埔寨
KI	Kiribati
KM	Comoros
KN	Saint Kitts and Nevis
KP	朝鲜
KR	韩国
KW	Kuwait
KY	Cayman Islands
KZ	Kazakhstan
LA	老挝
LB	Lebanon
LC	Saint Lucia
LI	Liechtenstein
LK	Sri Lanka
LR	Liberia
LS	Lesotho
LT	Lithuania
LU	Luxembourg
LV	Latvia
LY	Libya
MA	摩洛哥
MC	Monaco
MD	Moldova
ME	Montenegro
MF	Saint Martin (French part)
MG	Madagascar
MH	Marshall Islands
MK	North Macedonia
ML	Mali
MM	Myanmar
MN	Mongolia
MO	澳门
MP	Northern Mariana Islands
MQ	Martinique
MR	Mauritania
MS	Montserrat
MT	Malta
MU	Mauritius
MV	Maldives
MW	Malawi
MX	Mexico
MY	Malaysia
MZ	Mozambique
NA	Namibia
NC	New Caledonia
NE	Niger
NF	Norfolk Island
NG	Nigeria
NI	Nicaragua
NL	荷兰
NO	Norway
NP	Nepal
NR	Nauru
NU	Niue
NZ	New Zealand
OM	Oman
PA	Panama
PE	Peru
PF	French Polynesia
PG	Papua New Guinea
PH	菲律宾
PK	Pakistan
PL	Poland
PM	Saint Pierre and Miquelon
PN	Pitcairn
PR	Puerto Rico
PS	Palestine
PT	葡萄牙
PW	Palau
PY	Paraguay
QA	Qatar
RE	Réunion
RO	Romania
RS	Serbia
RU	俄罗斯
RW	Rwanda
SA	沙特阿拉伯
SB	Solomon Islands
SC	Seychelles
SD	Sudan
SE	Sweden
SG	新加坡
SH	Saint Helena
SI	Slovenia
SJ	Svalbard and Jan Mayen
SK	Slovakia
SL	Sierra Leone
SM	San Marino
SN	Senegal
SO	Somalia
SR	Suriname
SS	South Sudan
ST	Sao Tome and Principe
SV	El Salvador
SX	Sint Maarten (Dutch part)
SY	Syria
SZ	Eswatini
TC	Turks and Caicos Islands
TD	Chad
TF	French Southern Territories
TG	Togo
TH	泰国
TJ	Tajikistan
TK	Tokelau
TL	Timor-Leste
TM	Turkmenistan
TN	Tunisia
TO	Tonga
TR	土耳其
TT	Trinidad and Tobago
TV	Tuvalu
TW	台湾
TZ	Tanzania
UA	Ukraine
UG	Uganda
UM	United States Minor Outlying Islands
US	美国
UY	Uruguay
UZ	Uzbekistan
VA	Holy See
VC	Saint Vincent and the Grenadines
VE	Venezuela
VG	Virgin Islands (British)
VI	Virgin Islands (U.S.)
VN	越南
VU	Vanuatu
WF	Wallis and Futuna
WS	Samoa
YE	Yemen
YT	Mayotte
ZA	南非
ZM	Zambia
ZW	Zimbabwe

卡类型


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 $privateKeyStr): string
{
    $key = openssl_pkey_get_private($privateKeyStr);

    // 仅按自然升序对顶层键进行排序
    ksort($data, SORT_NATURAL);

    // 递归修整空格
    array_walk_recursive($data, function (&$v) {
        $v = is_string($v) ? trim($v) : $v;
    });

    openssl_sign(json_encode($data), $signature, $key, 'md5WithRSAEncryption');
    return base64_encode($signature);
}

function verifySignature(array $data, string $publicKeyStr): bool
{
    $signature = $data['signature'];
    unset($data['signature']);

    ksort($data, SORT_NATURAL);
    array_walk_recursive($data, function (&$v) {
        $v = is_string($v) ? trim($v) : $v;
    });

    $key = openssl_pkey_get_public($publicKeyStr);
    $result = openssl_verify(json_encode($data), base64_decode($signature), $key, 'md5WithRSAEncryption');
    return $result === 1;
}

Node.js

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

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');
}

GLODIPAY 结账 API 规范

目录

介绍

接口地址 (Endpoints)

签名 (Signature)

生成签名 (商户 -> GLODIPAY)

验证签名 (GLODIPAY -> 商户)

POST PAYMENT

请求参数

paymentMethod 取值

paymentFilter

请求示例

响应 -- connectionMode: API

响应 -- connectionMode: DIRECT_POST

发送到 callbackUrl 的数据

交易查询 (TRANSACTION QUERY)

请求 (Request)

响应 (Response)

通知 (NOTIFICATION)

Payload

fees 对象

paymentMethodDetails 对象

card 对象 (`paymentMethodDetails.card`)

响应 (商户 -> GLODIPAY)

模拟付款

附录

付款方式

连接模式

状态值

状态码

货币代码

国家代码

卡类型

代码示例

PHP

Node.js

Bookmarks

目录​

介绍​

接口地址 (Endpoints)​

签名 (Signature)​

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

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

POST PAYMENT​

请求参数​

paymentMethod 取值​

paymentFilter​

请求示例​

响应 -- connectionMode: API​

响应 -- connectionMode: DIRECT_POST​

发送到 callbackUrl 的数据​

交易查询 (TRANSACTION QUERY)​

请求 (Request)​

响应 (Response)​

通知 (NOTIFICATION)​

Payload​

fees 对象​

paymentMethodDetails 对象​

card 对象 (paymentMethodDetails.card)​

响应 (商户 -> GLODIPAY)​

模拟付款​

附录​

付款方式​

连接模式​

状态值​

状态码​

货币代码​

国家代码​

卡类型​

代码示例​

PHP​

Node.js​

Bookmarks

目录

介绍

接口地址 (Endpoints)

签名 (Signature)

生成签名 (商户 -> GLODIPAY)

验证签名 (GLODIPAY -> 商户)

POST PAYMENT

请求参数

paymentMethod 取值

paymentFilter

请求示例

响应 -- connectionMode: API

响应 -- connectionMode: DIRECT_POST

发送到 callbackUrl 的数据

交易查询 (TRANSACTION QUERY)

请求 (Request)

响应 (Response)

通知 (NOTIFICATION)

Payload

fees 对象

paymentMethodDetails 对象

card 对象 (`paymentMethodDetails.card`)

响应 (商户 -> GLODIPAY)

模拟付款

附录

付款方式

连接模式

状态值

状态码

货币代码

国家代码

卡类型

代码示例

PHP

Node.js