Developer Setup

Dùng checklist này trước khi xây merchant hoặc lender integration.

Environments

Surface	Sandbox	Production
Merchant BNPL APIs	https://gateway-sandbox.fundiin.vn	https://gateway.fundiin.vn
Lender webhooks	https://api-qa.fundiin.vn	https://api.fundiin.vn

Credentials

Fundiin cung cấp credentials trong quá trình onboarding.

Credential	Dùng để
Client-Id	Định danh merchant, platform hoặc lender partner.
secretKey	Ký và xác thực request body bằng HMAC SHA-256.
Portal access	Quản lý vận hành merchant, credentials và giao dịch.

Shared primitives

Các phần này dùng chung cho cả merchant và lender integration.

Thành phần	Cần implement
HMAC signing	Ký request gửi đi và verify callback nhận vào. Xem Signature.
Idempotency	Retry an toàn, không xử lý trùng. Xem Idempotency.
Webhooks	Nhận payment status, loan và repayment events. Xem Webhooks và Callbacks.

Shared tools

Tool	Dùng để
Postman Guide	Build và test signed request cho cả merchant hoặc lender APIs.
HMAC Signatures	Tạo chữ ký HMAC trên mọi integration surface.
Webhook Event Builder	Tạo signed webhook payload và cURL cho merchant callback hoặc lender notification.
Idempotency	Retry an toàn, không xử lý trùng.

Surface tools

Tool	Dùng để
API Explorer	Explore request API BNPL merchant, tokenization và lending.
Lending APIs	Vào nhanh nhóm notification vòng đời khoản vay và repayment của lender.
Merchant Demo	Thử trải nghiệm checkout BNPL phía merchant.
Test Instruments	Validate các kịch bản checkout merchant trên sandbox.