API接口说明
1. 通讯协议
| 类型 | 说明 |
|---|---|
| 传输方式 | 为保证交易安全性，采用HTTPS传输，且TLS版本不低于1.2，详情参考 TLS升级说明 |
| 提交方式 | 采用POST方法提交 |
| 数据格式 | 提交和返回数据都为application/json格式 |
| 字符编码 | 统一采用UTF-8字符编码 |
| 签名算法 | SHA256 |
| 签名要求 | 详细方法请参考 API 签名 |
| 判断逻辑 | 先判断协议字段返回，再判断业务返回，最后判断交易状态 |
2. 报文结构
HTTP请求
HTTP响应
3. 网关API请求地址
4. 接口列表
| 产品 | 集成模式 | 接口名称 | Endpoint | 描述 |
|---|---|---|---|---|
| 收款 | 收银台支付 | 下单 | 交易接口 | 使用 todaypay 收银台 |
| 纯API支付 | 下单 | 交易接口 | 商户可以自定义收银台 | |
| 收银台支付/纯API支付 | Webhook通知 | WebHook 介绍 | ||
| 交易查询 | 公共接口 | |||
| 付款 | API付款 | 下单 | 交易接口 | |
| Webhook通知 | WebHook 介绍 | |||
| 交易查询 | 公共接口 | |||
| 凭证查询 | 凭证查询 | 公共接口 | ||
| 账户余额 | 余额查询 | 实时余额查询 | 公共接口 |
5. OMS管理平台地址
| 地区 | OMS地址 |
|---|---|
| 北美洲 | {{latin_oms}} |
| 南美洲 | {{latin_oms}} |
| 亚洲 | {{asia_oms}} |
| 中东 | {{asia_oms}} |
| 欧洲 | {{asia_oms}} |
| 非洲 | {{af_oms}} |
6. 接口传参规则
| 是否必填 | 描述 |
|---|---|
| M | 必填（Mandatory） |
| O | 选填（Optional） |
| C | 特定条件下必填（Condition） |
Modified at 2025-09-03 11:42:16