切换主题
应用服务端 API
API 40.68.0 · 应用后端调用。
调用前准备
- 应用已配置有效 AppSecret；普通业务要求 active；draft 支持有效本地调试手机号兑换及具备支付资格的余额支付，详见手机号指南和调试支付。普通手机号另需主体资格和接口白名单。
- 将契约中的
platformOrigin替换为本应用 API 入口。文档域名不接收 API 调用。 - 按下表选择鉴权；AppSecret、接口 token、应用私钥和 session_key 只保存在业务后端。
| 接口类型 | 鉴权方式 |
|---|---|
| 登录兑换、微信兼容 token | HTTPS Query 中的 AppID 和 AppSecret |
| 手机号兑换 | Query 中的 access_token |
| 平台原生 token | JSON 中的 app_secret |
| 会话、诊断和支付查询 | Authorization: Bearer <接口 token>；会话另传 session Header |
| 余额下单与退款 | Bearer token 及四个应用请求签名 Header |
两条 MetaEco 余额资金写请求每次都必须附带应用后端生成的四个签名头；未登记有效支付请求公钥时，请求会被拒绝。签名方法见余额支付。
登录与会话
| 接口 | 方法与路径 |
|---|---|
| 小程序登录凭证校验 | GET /sns/jscode2session |
| 校验运行时会话 | POST /miniapp/v1/apps/{app_id}/runtime/sessions/validate |
| 吊销运行时会话 | POST /miniapp/v1/apps/{app_id}/runtime/sessions/revoke |
接口 token
| 接口 | 方法与路径 |
|---|---|
| 获取小程序接口 token | GET /cgi-bin/token |
| 获取接口调用 token | POST /miniapp/v1/apps/{app_id}/access-token |
手机号
| 接口 | 方法与路径 |
|---|---|
| 兑换小程序手机号 | POST /wxa/business/getuserphonenumber |
余额支付
| 接口 | 方法与路径 |
|---|---|
| 创建 MetaEco 余额支付单 | POST /miniapp/v1/apps/{app_id}/payments/orders |
| 应用后端查询 MetaEco 支付单 | GET /miniapp/v1/apps/{app_id}/payments/orders/{order_id} |
| 应用后端退回 MetaEco 余额支付 | POST /miniapp/v1/apps/{app_id}/payments/orders/{order_id}/refunds |
| 应用后端查询 MetaEco 余额退款 | GET /miniapp/v1/apps/{app_id}/payments/orders/{order_id}/refunds/{business_refund_no} |
| 获取 MetaEco 余额通知验签公钥 | GET /miniapp/v1/apps/{app_id}/payments/notification-key |
失败诊断
| 接口 | 方法与路径 |
|---|---|
| 应用后端查询单次失败诊断 | POST /miniapp/v1/apps/{app_id}/diagnostics/request |
结果与错误
微信兼容接口须同时检查 HTTP 状态与 errcode；平台原生接口按 HTTP 状态及 code/error 判断。响应请求 ID 用于失败诊断。