快速接入指南
第一步:获取商户参数
注册并登录商户后台,在「开发者 / API」页面获取以下参数:
| 参数 | 说明 | 示例 |
|---|---|---|
| 接口地址(网关URL) | 所有API请求的基础地址 | https://pay.camel-hub.cn/ |
| 商户ID(PID) | 您的商户编号 | 1001 |
| 商户密钥(Key) | 用于签名,切勿泄露 | abcd1234xxxx |
第二步:在您的系统中配置
常见系统配置示例
如果您的网站/系统支持「易支付」或「彩虹易支付」接口,按下方填写即可:
| 配置项 | 填写内容 |
|---|---|
| 支付接口类型 | 易支付 / 彩虹易支付 / EPay |
| 接口地址 / 网关URL | https://pay.camel-hub.cn/ |
| 商户ID / PID | 您的商户ID(后台获取) |
| 商户密钥 / Key | 您的商户密钥(后台获取) |
适用系统:独角数卡、发卡站、WHMCS、WordPress (WP-EPay插件)、Typecho、V免签、异次元发卡、个人发卡等所有支持易支付协议的系统。
自定义开发对接
如果您的系统没有内置易支付接口,可通过API对接:
| 接口 | 地址 | 方式 | 说明 |
|---|---|---|---|
| 页面跳转支付 | https://pay.camel-hub.cn/submit.php | GET/POST | 跳转到收银台完成支付 |
| API下单 | https://pay.camel-hub.cn/mapi.php | POST 表单 | 返回支付链接/二维码 |
| 订单查询 | https://pay.camel-hub.cn/api.php?act=order&pid={PID}&out_trade_no={订单号}&sign={签名} | GET | 查询订单状态 |
详细参数说明请参阅左侧目录中的各接口文档。
第三步:支付方式(type参数)
| type值 | 支付方式 | 说明 |
|---|---|---|
alipay | 支付宝 | 支持场景由当前绑定通道决定 |
wxpay | 微信支付 | 支持场景由当前绑定通道决定 |
第四步:测试支付
- 在商户中心打开「支付测试」,根据通道限额发起一笔测试订单
- 选择当前账户实际可用的支付方式完成付款
- 确认:①支付成功 ②异步通知(notify_url)收到回调 ③订单状态更新
- 测试通过后即可正式使用
常见问题
| 问题 | 解决 |
|---|---|
| 签名错误 | 检查密钥是否正确、参数是否按字母排序拼接 |
| 支付方式不存在 | 检查 type 是否出现在上方实时支付方式列表,并确认账户已获配可用通道 |
| 回调未收到 | notify_url 必须是公网可访问的地址,且返回 success |
| 订单金额不合法 | money 必须大于 0,格式为数字(如 0.01) |
