API 概览
本文档用于帮助开发者快速了解 邮联通支付平台API 的整体能力、设计规范及接入方式，便于您高效完成系统对接。
API 设计说明
邮联通API 采用统一的设计规范，确保接口清晰、易用、可维护。
- 接口风格：RESTful API
- 数据格式：JSON
- 安全机制：敏感信息加密 + 签名校验 + HTTPS
- 身份识别：商户号（mchNo） + 应用ID（appId） + 网站ID（storeId） + 密钥（secretKey）
典型调用流程
一次完整的支付接口调用流程如下：
- 📝 准备请求参数
按接口文档要求组装业务参数并生成签名。 - ⬆️ 发起 API 请求
通过 HTTPS 向 邮联通API 发起请求。 - ⚙️ 平台处理
平台完成参数校验、风控校验、通道路由等处理。 - ⬇️ 同步响应结果
返回接口调用结果及交易状态。 - 🔔 异步通知
平台通过回调地址推送最终交易结果。
商户信息
调用接口时所需要的参数信息，如商户号、应用ID、网站ID、密钥、加密公钥等，均由邮联通支付平台提供。
获取商户信息的方法请参考 获取接口接入信息 页面。
环境说明
为保障接入安全与稳定性，平台提供不同运行环境：
沙盒环境
用于开发、联调和测试，不产生真实资金交易。域名如下：https://pay.sandbox.ulinkcod.com正式环境
用于真实业务场景，请在完成测试后再切换。域名如下：https://pay.ulinkcod.com
注意
请勿在正式环境中使用沙盒的商户号以及密钥信息。
返回码
接口返回code字段用于标识接口调用是否成功，code字段取值如下：
| 返回码 | 描述 |
|---|---|
| 0 | 成功 |
| 9999 | 异常，详情见msg字段 |