API 概览
接口图谱 (Endpoint map)
托管结账 (Hosted checkout)
支持银行卡、钱包、银行转账及其他替代方式的多方式付款会话。
POST /v2/checkout
交易查询 (Transaction query)
在回调或 IPN 后，获取最新的交易状态和结算详情。
POST /v2/checkout/query
服务器对服务器银行卡
从商户后端直接提交银行卡详情。3DS 可能会返回重定向 URL。
POST /v2/card/api
银行卡 iFrame
创建托管银行卡输入 URL，确保卡信息获取过程在 GLODIPAY 内部进行。
POST /v2/card/iframe
创建退款
为已完成的交易发起退款。
POST /v2/refund
退款查询
在创建退款或 IPN 更新后，检查退款的当前状态。
POST /v2/refund/query
测试卡信息
| 类型 | 卡号 | 有效期 | CVV | 3DS 验证码 |
|---|---|---|---|---|
| 非 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 |
运营注意事项
Webhook 确认机制
在您的后端收到 IPN 后，请立即返回
{"returnCode":"100","description":"Received"}。沙盒测试卡
请仅使用沙盒环境。在测试模式下不会产生真实扣款。
生产环境 Base URL
生产环境主机名从商户后台分配，因此请确保每个商户的配置是可调的。
连接模式 (Connection modes)
| 模式 | 行为 |
|---|---|
DIRECT_POST | 浏览器立即重定向到托管的结账页面。 |
API | API 以 JSON 形式返回 paymentLink，以便商户控制重定向。 |
推荐阅读路径
- 如果您需要了解整个平台模型，请从 完整 API 规范 开始。
- 针对您正在集成的流程，使用特定的接口规范。
- 切换到交互式页面以验证 Payload 结构并生成代码。
源技术规范
如需了解完整的技术详情和整个平台模型，请参考 GLODIPAY API 规范 v2。