Bắt đầu tích hợp
Chuẩn bị Organization, PayOS, Product, ProductPrice, webhook và API key.
Trước khi viết code
Bạn cần một Organization VietBilling, thông tin tích hợp PayOS, recurring Product có ProductPrice, Organization API key và URL webhook HTTPS công khai.
Biến môi trường
VIETBILLING_API_URL=https://api.vietbilling.com
VIETBILLING_API_KEY=vb_live_replace_me
VIETBILLING_WEBHOOK_SECRET=whsec_replace_me
Giữ các giá trị này ở server. Không đưa API key hoặc webhook secret vào bundle trình duyệt.
Luồng tích hợp tối thiểu
- Tạo customer với mã người dùng nội bộ làm
external_id. - Tạo Checkout cho Product đã chọn; VietBilling resolve ProductPrice đang live.
- Chuyển khách hàng đến
checkout_url. - Kiểm tra Checkout ở server khi khách quay lại.
- Xử lý webhook để đồng bộ Subscription và BenefitGrants.
Hoàn tất
Trước production, thử cả thanh toán thành công, checkout bỏ dở, webhook gửi lại và một chu kỳ gia hạn. Xem API Reference để đối chiếu endpoint.