Xác minh định danh (eKYC)
Identity Verify API
Xác minh định danh khách hàng theo consent — nhóm “thông tin khách hàng có đồng ý” theo TT 64.
- POST/identity/verify
Sovico Group Open API Platform
Kết nối định danh eKYC, báo giá bảo hiểm và khởi tạo thanh toán từ các đơn vị thành viên — chuẩn FAPI 2.0, sẵn sàng Thông tư 64/2024/TT-NHNN. Identity verification, insurance quotes and payment initiation from Sovico member companies — FAPI 2.0 secured, SBV Circular 64 ready.
# 1 · Lấy access token (client credentials) curl -u $CLIENT_ID:$CLIENT_SECRET \ -d grant_type=client_credentials \ https://sandbox.136-82-48-104.nip.io/oauth2/token # 2 · Gọi INS-02 /quotes curl -X POST $SANDBOX/experience/openapi/v1/quotes \ -H "Authorization: Bearer $TOKEN" \ -H "X-Tenant-ID: external" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{"product":"travel","sum_insured":"50000000"}'
201Created · 142 ms · RateLimit-Remaining: 99 { "quote_id": "qte-2026-10-02-000118", "premium": "385000", "currency": "VND" }
Tài liệu và Try-it sinh tự động từ OAS gốc — không viết tay. Tải OAS hoặc Postman collection chỉ với một cú nhấp.
Identity Verify API
Xác minh định danh khách hàng theo consent — nhóm “thông tin khách hàng có đồng ý” theo TT 64.
Insurance Quotes API
Báo giá du lịch / xe / sức khỏe, idempotent. v2 phát hành song song, v1 có lịch ngừng (Sunset).
Payments Initiation API
Khởi tạo thanh toán từ tài khoản theo consent, Idempotency-Key bắt buộc — nhóm “khởi tạo giao dịch”.
Register & accept the Terms
Tạo tài khoản nhà phát triển và chấp nhận Điều khoản Sovico Open API v1.0 (click-through, có lưu vết).
≈ 3 phútCreate a sandbox app
Chọn gói sovico-openapi-public, nhận ngay Client ID / Secret cho môi trường sandbox.
Make your first call
Dùng Try-it ngay trên tài liệu hoặc import Postman collection — gọi cả 3 API trên sandbox.
< 20 phút tổng403 ENV-4031 ngay tại gateway — không request nào chạm backend production. Sandbox credentials are rejected on production at the gateway.
Nhà phát triển, đơn vị thử nghiệm
Miễn phí · vượt quota chặn 429, không tính phí
Fintech / merchant (C1)
Postpaid · 1.000 req/ngày miễn phí · >10.000: 1.000 VND/req
Đơn vị thành viên Sovico (C2)
Prepaid · gồm 100.000 req/ngày · vượt 300 VND/req
TPP Open Banking, đối tác chiến lược (C3)
Hợp đồng · gồm 1.000.000 req/ngày · vượt 150 VND/req
Giá tham chiếu giả lập phục vụ PoC DEMO-12 — không phải giá thực tế. So sánh chi tiết các gói
Security Profile
PAR (RFC 9126), PKCE S256, private_key_jwt và DCR (RFC 7591) cho TPP.
PAR · PKCE · DCRCertificate-bound tokens
Token gắn chứng thư (cnf.x5t#S256) — token bị lộ cũng không dùng được từ máy khác.
403 AUT-4031SBV Circular 64 grouping
API phân nhóm: thông tin · thông tin có đồng ý · khởi tạo giao dịch; báo cáo theo TPP.
TT 64/2024/TT-NHNNReal-time consent revocation
Khách hàng rút consent — mọi lệnh gọi của TPP bị từ chối 403 trong vài giây.
PAY-4032 · IDN-4033Problem+JSON everywhere
Mã lỗi thống nhất AAA-0000 kèm correlation_id.
Safe retries
Cùng Idempotency-Key + payload khác → 409 PAY-4091.
Partner governance
Điều khoản click-through có lưu vết, đình chỉ ≤ 5′, khôi phục duyệt 2 người.
Ready to build? Tạo ứng dụng sandbox và gọi API đầu tiên ngay hôm nay.