Sandbox SePay API v2

Sandbox SePay API v2 là môi trường thử nghiệm cách ly với Production: test API truy vấn giao dịch, tài khoản và VA bằng dữ liệu giả lập, không cần ngân hàng thật.

||

Sandbox là môi trường thử nghiệm của SePay API v2, cách ly hoàn toàn với Production. Bạn test đầy đủ các API truy vấn giao dịch, tài khoản ngân hàng và VA bằng dữ liệu giả lập, không chạm dữ liệu giao dịch thật và không cần liên kết ngân hàng thật. Vì vậy Sandbox phù hợp cho phát triển, kiểm thử tự động và giảng dạy tích hợp API.

Base URL Sandbox

Base URL của môi trường Sandbox SePay API v2:

Môi trườngBase URL
Sandboxhttps://userapi-sandbox.sepay.vn/v2

Lấy token Sandbox

Token Sandbox tạo trong API Access khi đang ở Test mode trên Dashboard. Token Production và token Sandbox là hai bộ riêng, mỗi token chỉ xác thực trên đúng base URL của môi trường đó.

1. Bật Test mode

Trên my.sepay.vn, mở Test mode ở sidebar để gạt công tắc sang bật. Banner vàng Test mode ở đầu trang xác nhận bạn đang ở chế độ thử nghiệm.

Bật Test mode trên my.sepay.vn để lấy token Sandbox SePay API
Nhấn để phóng to
Mở Test mode ở sidebar my.sepay.vn để bật chế độ thử nghiệm

2. Mở API Access trong Test mode

Vào Cấu hình Công ty → API Access. Mọi token tạo ở đây chỉ xác thực trên userapi-sandbox.sepay.vn/v2, hoàn toàn cách ly với Production.

Trang API Access trong Test mode để tạo token Sandbox SePay API
Nhấn để phóng to
Trang API Access trong Test mode với token đã được che

3. Tạo và sao chép token

Bấm Tạo token, đặt tên rồi xác nhận. Token chỉ hiện đầy đủ một lần ngay sau khi tạo, sao chép ngay vào nơi an toàn để dùng trong header Authorization: Bearer.

Token Sandbox SePay API v2 hiển thị đầy đủ một lần sau khi tạo
Nhấn để phóng to
Token chỉ hiện đầy đủ một lần, sao chép ngay vào nơi an toàn

Xem hướng dẫn đầy đủ: API Access trong Test mode.

Dữ liệu giao dịch, tài khoản và VA trong Sandbox sinh từ giao dịch mô phỏng trong Test mode, cách ly hoàn toàn với Production.

Gọi API trên Sandbox

Đặt base URL Sandbox userapi-sandbox.sepay.vn/v2 và gửi Bearer token Sandbox trong header:

>
>
curl https://userapi-sandbox.sepay.vn/v2/transactions \
  -H 'Authorization: Bearer YOUR_SANDBOX_TOKEN'

Cách gửi token, giới hạn rate và xử lý lỗi 401/429 có trong Xác thực & Rate Limiting.

VA theo đơn hàng hỗ trợ trên Sandbox

Toàn bộ API VA theo đơn hàng (BIDV, Sacombank, Vietcombank) hỗ trợ trên Sandbox: tạo đơn hàng, tiền tố VA, terminal và giả lập thanh toán trong Test mode.

Chuyển sang Production khi sẵn sàng

Sau khi test xong trên Sandbox, tạo token Production ở chế độ Live, cập nhật token mới vào cấu hình ứng dụng thay cho token Sandbox và đổi base URL sang https://userapi.sepay.vn/v2. Phần còn lại của tích hợp giữ nguyên.

Trước
—
Tiếp theo
—