快速开始
接入准备、环境信息和第一个请求。
接入准备
开始集成前，先完成以下准备工作：
- 创建 API 密钥：登录控制台，在「集成 → 密钥管理」点击「新增密钥」，获取
client_id和client_secret。tenant_id显示在密钥列表的「租户 ID」列 - 配置 IP 白名单：在密钥的「修改 IP 白名单」中填写服务器出口 IP，支持 IPv4、IPv6 和 CIDR，多个用英文逗号分隔。留空表示不限制来源 IP，建议在生产环境配置
- 配置 Webhook：在「集成 → Webhooks」点击「添加 Endpoint」，填写可公网访问的 HTTPS 回调地址
- 生成幂等键：所有
POST请求必须提供唯一的Idempotency-Key
环境信息
| 环境 | Base URL | 说明 |
|---|---|---|
| 测试环境 | https://api.test.stabofx.com | 用于开发和测试 |
| 生产环境 | https://api.stabo.io | 正式生产环境 |
以下示例使用测试环境地址。上线时把 Base URL 换成生产环境地址。
业务接口示例使用相同的占位符：Java、Python、Node 示例中的 BASE_URL 是上表的 Base URL；accessToken（Python 中为 access_token）和 curl 示例中的 {accessToken} 是鉴权中获取的 Access Token。
第一个请求
以下是一个完整的调用流程示例。
获取 Access Token
curl -X POST "https://api.test.stabofx.com/oauth2/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "X-Tenant-ID: your_tenant_id" \
-H "X-Tenant-Type: COMPANY" \
-d "grant_type=client_credentials&client_id=your_client_id&client_secret=your_client_secret&scope=company:TENANT:admin"Java、Python、Node 写法见鉴权。
调用业务接口
以 Checkout 的创建 Payment Intent 为例。金额用标准单位十进制字符串。"20.00" 表示 20.00 USD。
curl -X POST "https://api.test.stabofx.com/openapi/v1/payment-intents" \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: pi_20260511_0001" \
-d '{
"amount": "20.00",
"currency": "USD",
"referenceNo": "ORD-20260511-0001",
"description": "Order #20260511-0001",
"customer": "cus_123456",
"brand": "Acme Coffee",
"successUrl": "https://merchant.example.com/success",
"cancelUrl": "https://merchant.example.com/cancel",
"expiryMinutes": 30,
"metadata": {
"orderId": "ORD-20260511-0001",
"merchantUserId": "user_123456"
}
}'下一步：