Customers

Một customer ID nối người dùng của bạn với billing lifecycle.

Tạo customer một lần, lưu ID trong database của ứng dụng và tái sử dụng cho các checkout tiếp theo.

Bắt đầu miễn phí

Kết quả

Cùng một người dùng không bị nhân bản chỉ vì request được retry.

Ánh xạ user

Chọn user ID nội bộ làm phần ổn định của idempotency key.

Tạo customer

Gửi tên, email và metadata cần thiết từ backend.

Lưu customer_id

Dùng ID trả về cho mọi checkout của người dùng đó.

Tích hợp từ backend

API key là secret của server. Không đặt key trong browser hoặc mobile app.

curl -X POST "$BASE_URL/customers" \
  -H "Authorization: Bearer vb_live_..." \
  -H "Idempotency-Key: customer_user_123" \
  -H "Content-Type: application/json" \
  -d '{"name":"Nguyen Van A","email":"[email protected]"}'

FAQ

Có tạo customer mỗi checkout không?

Không. Tạo một lần và lưu customer_id trong database của ứng dụng.

Retry có tạo trùng không?

Request giống nhau với cùng idempotency key trả lại customer ban đầu.