Tích hợp API thanh toán cần một thỏa thuận rõ giữa kinh doanh, kỹ thuật và vận hành. Phản hồi nhận yêu cầu chưa đủ để kết luận thanh toán đã hoàn tất. Dùng checklist này để chuẩn bị thảo luận, không thay thế tài liệu API áp dụng cho tài khoản.
Xác định phạm vi
Ghi thị trường, tiền tệ, phương thức thu hộ hoặc điểm đến chi hộ và hệ thống cần kết nối. CVPay hỗ trợ VND, PHP, USDT qua một tài khoản thương nhân và một API; thị trường tiền pháp định là Việt Nam và Philippines. Phương thức thu hộ được mở cần xác nhận theo tài khoản, không suy ra khả năng chi hộ tới ví.
KYB và môi trường
Doanh nghiệp phải qua xét duyệt KYB; sandbox được mở trước production và hai môi trường tách biệt. Xác nhận tài liệu, quyền truy cập và giới hạn thử nghiệm áp dụng cho từng môi trường, không giả định sandbox mô phỏng mọi tình huống.
Chốt hợp đồng API
Yêu cầu tài liệu hiện hành về xác thực, trường bắt buộc, biểu diễn số tiền và tiền tệ, liên kết đơn hàng, trạng thái và xử lý lỗi. Không tự đặt endpoint, thuật toán hay quy tắc thử lại từ ví dụ của nhà cung cấp khác.
Trạng thái và webhook
CVPay có webhook mang chữ ký khi trạng thái thanh toán thay đổi. Lấy hướng dẫn kiểm tra chữ ký áp dụng cho tài khoản. Hỏi cách xử lý thông báo lặp, chậm hoặc không xác thực được; đây là câu hỏi cần chốt, không phải khẳng định một chính sách retry cụ thể.
Bằng chứng kiểm thử
Với mỗi tình huống được thống nhất, ghi điều kiện, kết quả mong đợi, kết quả thực tế, bằng chứng và người kiểm tra. Nếu không thể mô phỏng, ghi giới hạn và quy trình vận hành thay vì đánh dấu đã kiểm thử. Không dùng sandbox để cam kết thời gian tiền tới ngân hàng.
Bàn giao và đo lường
Chỉ định người xử lý giao dịch chưa rõ kết quả, bảo vệ thông tin truy cập và dữ liệu khách hàng. Chốt phí, hạn mức và phương thức thực tế riêng. Tách lượt truy cập, lần thử thanh toán, kết quả thanh toán và hoàn thành đơn hàng; một API request không phải giao dịch thành công hay khách hàng mới. Trước production, xử lý các vấn đề ảnh hưởng tới luồng tiền hoặc việc giao hàng.