Customers

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

Quản lý customer bằng request idempotent, lưu customer_id vào database và tái sử dụng cho mọi chu kỳ checkout. Tránh trùng lặp tài khoản khi retry mạng.

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.

Nội dung liên quan

Webhooks PayOS Integration