Tổng quan API Cổng Thanh Toán

Base URLs

Cổng thanh toán SePay cung cấp hai môi trường để tích hợp — Sandbox dùng cho kiểm thử và Production cho giao dịch thật:

Môi trường	Base URL
Production	`https://pgapi.sepay.vn`
Sandbox	`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
  }
}