Tạo API Token cho SePay API v2

Tạo API Token trong SePay để xác thực request API v2. Bước bắt buộc trước khi gọi bất kỳ endpoint SePay API v2 nào với xác thực Bearer token.

||
Lưu ý

API Token dùng chung cho cả API v1 và v2. Nếu đã có token từ v1, bạn có thể sử dụng lại mà không cần tạo mới.

Các bước tạo API Token

  • Bước 1: Vào Cấu hình Công ty → API Access

    Tạo token Test mode

    Để test tích hợp mà không ảnh hưởng dữ liệu Production, bật Test mode ở sidebar my.sepay.vn rồi vào API Access trong Test mode. Token tạo ở đây chỉ xác thực được trên endpoint userapi-sandbox.sepay.vn, hoàn toàn cách ly với Production. Xem chi tiết: API Access trong Test mode.

  • Bước 2: Chọn vào button + Thêm API ở phía trên, bên phải

  • Bước 3: Điền đầy đủ thông tin, bao gồm:

    • Tên: Bạn đặt tên bất kỳ
    • Trạng thái: Chọn Hoạt động
  • Bước 4: Chọn Thêm

    • Sau khi thêm thành công, bạn sẽ thấy API Token tại danh sách API Access.
Lưu ý

Hiện tại SePay chưa hỗ trợ phân quyền cho API. Điều này đồng nghĩa với việc API Key được tạo có toàn quyền.

Hướng dẫn sử dụng API Token

  • API Token cần được đưa vào header mỗi khi request đến SePay API. Với cấu trúc Authorization: Bearer API_TOKEN

  • Ví dụ sử dụng API Token để lấy thông tin giao dịch

API Token SePay
Nhấn để phóng to
API Token SePay