外观
面向商户开发者的支付接入文档。分服务认证、明确的幂等语义,以及可验证的 Webhook 事件。
创建代收意图、取消、退款,以及信用卡与 Tokenization 写操作。
创建和取消转账意图;使用独立的 Transfer 凭证与 Host。
查询订单、退款、账户、余额、信用卡与 Token 元数据。
验签、去重、快速应答,并以查询 API 作为最终状态依据。
每个写请求都能安全恢复,避免网络超时带来的重复支付风险。
一份可执行的认证、回调、监控和故障演练清单。
Gateway 对外由多个服务组成。代收写、代付写和查询使用不同的 Host 与签名命名空间;不要创建一个包办所有请求的 base URL。
接入原则
服务选对、凭证匹配、签名可复现、写请求有幂等键、Webhook 可去重——这五项是稳定接入的基础。