API 接入文档
1. 签名规则
把参数按 key 升序排列,拼成 k1=v1&k2=v2&...&kn=vn(空值不参与),末尾追加 &key=商户密钥,取 MD5 小写作为 sign。
2. 发起支付
请求:POST/GET https://pay.pbj1.cn/submit(表单跳转)
| 字段 | 说明 | 示例 |
|---|---|---|
| pid | 商户号 | 10000001 |
| type | 支付渠道 | wxpay / alipay |
| out_trade_no | 商户订单号 | 202609301230001 |
| name | 商品名称 | 会员充值 |
| money | 金额(保留两位小数) | 9.90 |
| notify_url | 异步通知地址 | https://xxx/notify.php |
| return_url | 同步跳转地址 | https://xxx/return.php |
| sign | 签名(MD5 小写) | abc… |
3. 订单查询
GET https://pay.pbj1.cn/api/query?pid=..&trade_no=..&sign=..
返回 JSON:{code,msg,trade_no,out_trade_no,type,money,status,paid_at}
status:0 待付 / 1 已付 / 2 已回调 / 3 超时
4. 异步通知
系统会以 POST 表单 通知你的 notify_url,字段:
- pid、trade_no、out_trade_no、type、name、money、trade_status=TRADE_SUCCESS、sign、sign_type=MD5
验证签名通过后,请返回字符串 success,否则系统会按重试策略再次通知。