Tổng quan Partner API

Partner API gồm những gì

• Partner users — tạo người dùng cuối, xem số dư, chạy luồng KYC.
• Transfers — crypto-to-fiat (offramp) và fiat-to-crypto (onramp), tỷ giá, lịch sử, hạn mức ngày.
• Virtual accounts — VA VND nội địa, chuyển VA↔VA và VA↔ví, rút về ngân hàng.
• Cấu hình — system configs (phí, hạn mức) và đăng ký webhook.

Base URL và versioning

Mọi endpoint partner nằm dưới /api/v2 trên host API mà Zenith cấp khi onboarding:

curl -X POST https://<zenith-api-host>/api/v2/partners/users \
  -H "X-Access-Key-ID: $KEY_ID" \
  -H "X-Access-Key-Secret: $KEY_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"userId": "ext-user-001"}'

Response envelope

Response dùng chung một envelope. Thành công trả success: true kèm payload data; lỗi trả success: false kèm code đọc được bằng máy và httpCode.

{ "success": true, "data": { /* ... */ } }

{
  "success": false,
  "message": "Invalid webhook url",
  "code": "invalid_webhook_url",
  "httpCode": 400
}

Nhận quyền truy cập

1. Ký hợp đồng đối tác với Zenith — bộ phận vận hành tạo partner record và bật scope.
2. Zenith cấp cặp X-Access-Key-ID / X-Access-Key-Secret cùng base URL của môi trường.
3. Đăng ký ít nhất một webhook domain nếu cần nhận callback đơn hàng.
4. Chỉ gọi API server-to-server; xem Xác thực.