Tổng quan API

Tổng quan về API cổng thanh toán SePay bao gồm base URLs, xác thực và các endpoints.

URL

https://pgapi-sandbox.sepay.vn

Tất cả các API của SePay đều sử dụng Basic Authentication để xác thực.

Headers

Authorization: Basic base64(merchant_id:secret_key)
Content-Type: application/json

200Thành công

Request được xử lý thành công

400Bad Request

Dữ liệu request không hợp lệ

401Unauthorized

Xác thực thất bại

403Forbidden

Không có quyền truy cập API này

404Not Found

Không tìm thấy tài nguyên yêu cầu

422Unprocessable Entity

Dữ liệu hợp lệ nhưng không thể xử lý (validation errors)

429Too Many Requests

Vượt quá giới hạn rate limit

500Internal Server Error

Lỗi server

Các API trả về danh sách đều hỗ trợ phân trang:

per_pageinteger

Số lượng kết quả mỗi trang (mặc định: 20, tối đa: 100)

pageinteger

Trang hiện tại (mặc định: 1)

RESPONSE

{
  "data": "[...]",
  "meta": {
    "per_page": 20,
    "total": 100,
    "has_more": false,
    "current_page": 1,
    "page_count": 5
  }
}