Flex Rent（Avance）接口集成 · OpenFinance 解决方案

API 集成与协议实现说明

下述为我们推荐的集成路径与关键端点示例，适配 Flex Rent 的租金分期场景（创建分期、发起代付、回调同步、对账导出）。

关键端点（示例）

POST /v1/rentals/agreements
Content-Type: application/json
Authorization: Bearer <CLIENT_ACCESS_TOKEN>

{
  "user_id": "u_12345",
  "property_id": "p_9876",
  "monthly_rent": 1200.00,
  "term_months": 3,
  "first_due_date": "2025-12-01",
  "payout_method": "bank_transfer",
  "bank_account": {"iban":"...","name":"..."}
}

Response: 201 Created
{
  "agreement_id": "agr_abc123",
  "status": "PENDING_APPROVAL",
  "schedule": [...]
}

代付与结算

我们建议使用托管/代付账户（受监管的支付机构）或与银行直连的清算通道。代付示例：

POST /v1/payouts
Authorization: Bearer <SERVICE_TOKEN>
{
  "agreement_id":"agr_abc123",
  "amount":1200.00,
  "payee": {"type":"landlord","bank_account":{...}},
  "reference":"rent-2025-12"
}

Webhook / 回调

推荐使用签名的回调（HMAC）来验证事件来源：

POST /webhooks/payouts
Headers:
  X-Signature: sha256=... (HMAC of body)
Body: {"payout_id":"po_123","status":"SETTLED","settled_at":"..."}

对账导出

支持 CSV 与 OFX 格式的批量对账文件导出，便于财务系统（ERP）入账。

我们的交付清单（样例）

• OpenAPI（Swagger）规范与示例请求/响应
• Node.js / Python 客户端 SDK 与示例脚本
• Webhook 验签实现与本地测试脚本
• 协议与授权流程分析报告（包含 OAuth、第三方清算接入点）
• 接口自动化测试与示例 Postman 集合
• 合规建议与最小化数据保留策略