OAuth cho ứng dụng
✧ Mở bằng AI
Khách hàng cấp quyền cho ứng dụng truy cập dữ liệu Pay2S mà không chia sẻ SecretKey tài khoản. OAuth hiện hỗ trợ ngân hàng, giao dịch và webhook; không cấp quyền chuyển tiền, tạo thanh toán hay xuất hóa đơn. BankHub và API key hoạt động độc lập.
Bắt đầu theo nhu cầu
- Đăng ký ứng dụng cá nhân hoặc đối tác.
- Thử luồng OAuth từ đầu đến cuối trong Playground.
- Scopes và giới hạn quyền truy cập.
- Nhận và xác minh webhook.
- Lỗi, hết hạn và giới hạn dịch vụ.
Ứng dụng cá nhân chỉ kết nối tài khoản tạo app. App đối tác chưa duyệt cho phép chủ app và khách demo Pay2S thử kết nối; khách thật khác cần app được duyệt. Khách sử dụng ứng dụng chỉ đăng nhập và cấp quyền, không cần tạo app hoặc gửi xét duyệt.
Danh sách API
Mỗi API có trang riêng: tham số, xác thực, response, lỗi và nút mở đúng endpoint trong Playground.
| Method | Endpoint | Tài liệu |
|---|---|---|
GET |
/api/v1/oauth/authorize |
Yêu cầu cấp quyền |
POST |
/api/v1/oauth/token |
Đổi mã lấy token |
POST |
/api/v1/oauth/token |
Làm mới token |
POST |
/api/v1/oauth/revoke |
Thu hồi kết nối |
GET |
/api/v1/oauth/me |
Thông tin tài khoản |
GET |
/api/v1/oauth/bank-accounts |
Danh sách ngân hàng |
GET |
/api/v1/oauth/transactions |
Danh sách giao dịch |
GET |
/api/v1/oauth/webhooks |
Danh sách webhook |
POST |
/api/v1/oauth/webhooks |
Tạo webhook |
PATCH |
/api/v1/oauth/webhooks/{id} |
Bật / tắt webhook |
DELETE |
/api/v1/oauth/webhooks/{id} |
Xóa webhook |
Thời hạn kết nối
Authorization Code có hiệu lực 120 giây, dùng một lần. Access token tối đa 15 phút, refresh token tối đa 30 ngày, kết nối tối đa 90 ngày. Mỗi lần refresh phải lưu cả hai token mới. Khách có thể ngắt tại Ứng dụng đã kết nối.