OAuth cho ứng dụng

Nội dung Markdown đầy đủ của trang tài liệu.

# OAuth cho ứng dụng

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](/docs/oauth/register/).
- [Thử luồng OAuth từ đầu đến cuối trong Playground](/docs/oauth/quickstart/).
- [Scopes và giới hạn quyền truy cập](/docs/oauth/scopes/).
- [Nhận và xác minh webhook](/docs/oauth/webhook-receiver/).
- [Lỗi, hết hạn và giới hạn dịch vụ](/docs/oauth/errors/).

Ứ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.

## Đọc tài liệu theo nhóm

| Nhóm | Nội dung |
|---|---|
| [Luồng xác thực](/docs/oauth/authentication-flow/) | Từ yêu cầu cấp quyền, callback đến gọi API |
| [Access Token](/docs/oauth/access-token/) | Đổi mã, làm mới và thu hồi kết nối |
| [Tài khoản ngân hàng](/docs/oauth/bank-accounts/) | Các ngân hàng được khách cho phép |
| [Giao dịch](/docs/oauth/transactions/) | Truy vấn giao dịch theo ngân hàng và ngày |
| [Webhook](/docs/oauth/webhooks/) | Danh sách, tạo, bật/tắt, xóa và xác minh chữ ký |
| [Người dùng](/docs/oauth/me/) | Mã tài khoản đã cấp quyền |

Trong từng nhóm có tài liệu endpoint và nút mở đúng API trong Playground.

## 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](https://pay2s.vn/client/oauth-connections).