Bắt đầu tích hợp
Hướng dẫn từng bước thiết lập Organization, kết nối cổng thanh toán, cấu hình Product, ProductPrice, webhook endpoint và tạo API key để tích hợp billing.
Trước khi viết code
Bạn cần một Organization VietBilling, credential cổng thanh toán đã cấu hình, 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.