自建网关接入

如果你已经有一套自己的收单服务或聚合网关,可以通过路由层提供的 HTTP 接口接入,返回结构统一,对账口径与控制台里其它通道完全一致。

接口约定

  • 取通道:POST /wp-json/wudiab/v1/route,返回本次使用的通道与 route_ref
  • 回写结果:POST /wp-json/wudiab/v1/confirm,回传 paid / failed / refunded / canceled 与交易号
  • 鉴权:请求头 X-Wudiab-Key + HMAC-SHA256 签名,时间戳超过 5 分钟的请求会被拒绝

对账一致性

自建网关的订单同样写入统一流水表:订单号、金额、币种、通道、状态、交易号逐笔可查,导出 CSV 时与其它通道混在一起按时间排序,财务不需要额外口径。

支持的收款方式

取通道接口

POST /wp-json/wudiab/v1/route,返回通道、route_ref 与过期时间。

查看接口文档 →

结果回写

POST /wp-json/wudiab/v1/confirm,回传状态与交易号。

查看接口文档 →

签名与限流

HMAC-SHA256 签名、时间戳防重放、IP 白名单与每分钟限流。

查看安全说明 →

常见问题

自建网关需要改多少代码?

通常只需要两处:下单前取通道,支付完成后回写结果。

返回结构和我现有的怎么对齐?

路由层返回统一的通道结构,字段映射在我们这边完成。

已经有自己的收单服务?

把你现有的回调结构发给我们,我们给出最短对接路径。

本页目录

需要接入支持?

把你的支付机构、账号数量与日均单量发给我们,回一份接入方案。

联系我们 →