# 1. 换取访问令牌
curl -X POST https://<API 域名>/open-api/merchant/auth/token \
-H 'Content-Type: application/json' \
-d '{ "appKey": "<AppKey>", "appSecret": "<AppSecret>" }'
# 2. 创建支付订单(金额单位:分)
curl -X POST https://<API 域名>/open-api/merchant/payment/orders \
-H 'Authorization: Bearer <访问令牌>' \
-H 'Content-Type: application/json' \
-d '{ "merchantOrderNo": "ORDER202610130001", "paymentAmount": 1990,
"payMethod": "WECHAT", "accessType": "QR" }'字段与当前公开接口一致;完整参数、枚举和响应以 API 文档为准。
接口能力
收款要用到的接口,都在这里。
公开接口统一在 /open-api/** 下,参数和响应以 API 文档为准。
统一下单
生成收款二维码或拉起支付。
POST /open-api/merchant/payment/orders订单查询
按商户订单号或支付单号查询支付状态。
GET /open-api/merchant/payment/orders/get退款
全额或部分退款,可查询退款状态。
POST /open-api/merchant/payment/refunds访问令牌
应用凭证换取访问令牌,按权限范围开放。
POST /open-api/merchant/auth/token关单
未支付的订单主动关闭。
POST /open-api/merchant/payment/orders/close付款人授权
小程序 / 公众号场景下获取付款人身份。
POST /open-api/merchant/payment/payer-authorizations
接入步骤
四步完成接入。
- STEP 01
申请应用
在商户端或代理端创建应用,拿到应用凭证。
- STEP 02
换取令牌
用应用凭证调用令牌接口,获取访问令牌(Bearer Token)。
- STEP 03
调用接口
带上令牌调用下单、查单、退款等接口。
- STEP 04
测试后上线
先在测试环境联调,确认回调和对账没问题后切正式。
接口安全
令牌、权限、白名单。
- 访问令牌应用凭证换取 Bearer Token,令牌过期后重新获取。
- 权限范围每个应用只开放申请过的接口。
- IP 白名单可限定只允许你的服务器调用。
- 防重复提交同一商户订单号重复下单不会重复扣款。
需要测试账号或技术对接?
留下联系方式,我们安排技术人员和你对接。