快速开始
本页帮助商户快速完成 Beyounger Payment API 的基础接入。
1. 获取 API Key
登录商户后台创建或获取 API Key：
https://merchant.beyounger.com/auth/login
API Key 使用 Bearer Token 方式传入请求头。
如果创建 API Key 时没有设置有效期，系统默认有效期为 30 天。生产环境请确认有效期并提前规划轮换。
2. 配置请求基础地址
生产环境基础地址：
https://app.beyounger.com
如果你的账号有测试环境，请使用 Beyounger 提供的对应测试地址和测试凭据。
3. 验证凭据
建议先调用：
GET /payment/account
确认 token 对应的商户账号、账户状态和币种能力正确。
4. 选择业务流程
常见接入入口：
| 业务 | 推荐入口 |
|---|---|
| 查询账户和余额 | GET /payment/account、GET /payment/balances |
| 法币出金 | POST /payment/quickpayout |
| 收单 PayIn | POST /payment/acquiring/orders |
| 异步状态通知 | Webhook |
5. 处理异步结果
支付和出金通常不是同步终态。商户应：
- 保存业务单号和 Beyounger 返回的 ID
- 接收 Webhook 更新状态
- 使用查询接口做最终确认和补偿查询