Chuyển đến nội dung chính

SDKs & Libraries

Đẩy nhanh quá trình tích hợp bằng cách sử dụng SDK chính thức cho TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby và React Native. Những thư viện này đơn giản hóa các yêu cầu API, xác thực và xử lý lỗi, cho phép bạn tập trung vào việc xây dựng trải nghiệm thanh toán tuyệt vời.

​
URL Môi trường

Tìm hiểu thêm về Test Mode vs Live Mode.

​
Quản lý Khóa API và Xác thực

1

Access API Keys

Đi tới Developer → API Keys trong bảng điều khiển của bạn để quản lý các khóa.
2

Generate a New Key

Chọn Add API Key, cung cấp tên mô tả và cấu hình quyền ghi:
  • Bật quyền truy cập ghi (đã chọn): Quyền đọc và ghi đầy đủ cho tất cả các hoạt động API
  • Bật quyền truy cập ghi (không chọn): Quyền truy cập chỉ đọc - chỉ có thể lấy dữ liệu (thanh toán, đăng ký, khách hàng, sản phẩm). Không thể tạo hoặc sửa đổi tài nguyên.
Bỏ chọn “Enable write access” cho các tích hợp bảng điều khiển, công cụ phân tích và bất kỳ hệ thống nào chỉ cần xem dữ liệu mà không thực hiện thay đổi.
3

Store Your Key Securely

Sao chép khóa được tạo ngay lập tức và đảm bảo nó được lưu trữ an toàn.
4

Authenticate Your API Requests

Sử dụng các khóa API của bạn để xác thực mọi yêu cầu. Áp dụng định dạng ủy quyền sau:
Authorization: Bearer YOUR_API_KEY
Không bao giờ tiết lộ các khóa API bí mật ở phía client hay trong kho lưu trữ công khai.

​
Định dạng Phản hồi

{
  "id": "pay_1234567890",
  "status": "completed",
  "amount": 2999,
  "currency": "USD",
  "created_at": "2024-01-15T10:30:00Z"
}

​
Giới hạn Tốc độ

API của chúng tôi sử dụng hệ thống hạn chế tỷ lệ hai cửa sổ với khả năng chống đột biến. Các giới hạn được áp dụng dựa trên phương thức xác thực và cấp kinh doanh của bạn.

​
Giới hạn mặc định (Cấp 0)

Cửa sổGiới hạn
Trên giây (Đột biến)40 yêu cầu
Trên phút (Duy trì)240 yêu cầu

​
Các cấp kinh doanh

Các giới hạn tỷ lệ cao hơn có sẵn cho doanh nghiệp có nhu cầu API tăng lên:
CấpĐột biến (trên giây)Duy trì (trên phút)
Cấp 0 (Mặc định)40240
Cấp 11001.000
Cấp 25005.000
Liên hệ hỗ trợ để nâng cấp doanh nghiệp của bạn lên cấp giới hạn tỷ lệ cao hơn.

​
Yêu cầu chưa xác thực

Các yêu cầu không có tiêu đề xác thực hợp lệ bị giới hạn tỷ lệ theo địa chỉ IP:
Cửa sổGiới hạn
Trên giây (Đột biến)20 yêu cầu
Trên phút (Duy trì)100 yêu cầu

​
Các tiêu đề giới hạn tỷ lệ

Giám sát việc sử dụng của bạn với các tiêu đề phản hồi sau:
  • X-RateLimit-Limit - Số yêu cầu tối đa cho phép
  • X-RateLimit-Remaining - Số yêu cầu còn lại trong cửa sổ hiện tại
  • X-RateLimit-Reset - Thời điểm giới hạn tỷ lệ được đặt lại
Khi bạn vượt quá giới hạn tỷ lệ, API trả về phản hồi 429 Too Many Requests. Áp dụng chiến lược lùi theo hàm mũ trong logic thử lại của bạn.

​
Xử lý lỗi

Để quản lý lỗi hiệu quả, hãy tham khảo các phần Error Codes và Transaction Failures để có hướng dẫn chi tiết.

Error Codes

Tìm hiểu sâu về các chi tiết lỗi toàn diện và cách khắc phục chúng.

Transaction Failures

Thu thập thông tin về các vấn đề giao dịch phổ biến và cách giải quyết chúng.

​
Webhooks

Nhận thông báo thời gian thực về các sự kiện thanh toán. Xem Webhook Guide để biết hướng dẫn thiết lập.

Webhook Guide

Thiết lập webhook để nhận thông báo thời gian thực và xử lý sự kiện.