服务器到服务器卡 API

Ask AI

端点合约

直接从您的服务器向 GLODIPAY 发送卡详情。此流程要求商户侧具备符合 PCI 标准的卡信息采集能力。

POST /v2/card/apiapplication/json需要签名

请求参数

字段	类型	必填	描述
merchantId	String(1,50)	M	商户 ID。
orderRef	String(1,250)	M	唯一交易引用。
amount	Float	M	发票金额。最小 1。
currency	String(3)	M	ISO 4217 货币代码。
cancelUrl	String(1,300)	M	取消时的 HTTPS 重定向 URL。
callbackUrl	String(1,300)	M	付款成功后的 HTTPS 重定向 URL。
notificationUrl	String(1,300)	M	HTTPS Webhook 端点。
errorUrl	String(1,300)	M	付款出错时的 HTTPS 重定向 URL。
orderDescription	String(max:3000)	M	简短订单描述。
metadata	JSON	O	附加的键值对数据。
transactionDocuments	JSON	O	支持文件。
paymentMethod	String	M	必须为 card。
feeBySeller	Number(0-100)	O	卖家费用百分比。
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	电话国家代码。
billingPhoneNumber	String(max:30)	M	电话号码。
cardNumber	String(12,19)	M	卡号。
cardMonth	String	M	过期月份，例如 12。
cardYear	String	M	2 位过期年份，例如 30。
cardSecurityCode	String(3,4)	M	CVV / CVC。
customerIp	String	M	客户 IP 地址。
websiteUrl	String(max:300)	O	商户网站 URL。
expiresAt	String	O	ISO 8601 会话过期时间。
browserDetails	JSON	M	浏览器指纹对象。
signature	String(max:750)	M	RSA-MD5 签名。

响应情况

响应状态值：

• success — 立即完成付款。返回 data.transactionId。
• redirect — 需要 3DS。将买家重定向到 data.url。3DS 完成后，GLODIPAY 会通过 IPN 发送结果并将买家重定向到 callbackUrl。
• pending — 等待 PSP 确认。最终结果将通过 IPN 发送。
• error — 付款失败。验证错误返回 HTTP 422（带有 errors 数组），处理错误返回 HTTP 400/500。

来源

此页面派生自 服务器到服务器卡支付 API。