Checkout & Payments

Checkout PayOS được tạo từ một request idempotent.

Tạo payment link cho Product, xử lý timeout an toàn và poll trạng thái bằng Checkout ID.

Bắt đầu miễn phí

Kết quả

Retry cùng idempotency key không tạo thêm một Order logic mới.

Gửi checkout request

Backend gửi customer, price và redirect URL.

Chuyển tới PayOS

Ứng dụng dùng checkout_url trong response.

Đối soát

Poll session khi request timeout hoặc trạng thái còn creating.

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/checkouts" \
  -H "Authorization: Bearer vb_live_..." \
  -H "Idempotency-Key: checkout_order_123" \
  -H "Content-Type: application/json" \
  -d '{"customer_id":"CUSTOMER_UUID","product_id":"PRODUCT_UUID","success_url":"https://app.example/success","cancel_url":"https://app.example/cancel"}'

FAQ

Nếu request timeout thì sao?

Poll Checkout hoặc retry cùng idempotency key; không tạo key mới cho cùng intent.

Checkout có thể tạo Customer không?

Có. Truyền external customer ID và email khi chưa có customer_id.