Thu hồi kết nối

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

# Thu hồi kết nối

`POST https://api.pay2s.vn/api/v1/oauth/revoke`

## Xác thực

Client ID + Secret. 

## Tham số

Định dạng: **application/x-www-form-urlencoded**.

| Trường | Kiểu nhập | Yêu cầu |
|---|---|---|
| `client_id` | string | Bắt buộc |
| `client_secret` | string | Bắt buộc |
| `token` | string | Bắt buộc |

Body form-urlencoded. token là access token hoặc refresh token của ứng dụng. Thu hồi toàn bộ kết nối chứa token, dừng các token và webhook liên quan. Token không tồn tại hoặc không thuộc ứng dụng vẫn trả success, không tiết lộ thông tin.

## Cách thử

Mở Playground bằng nút đầu trang, nhập thông tin của ứng dụng hoặc Access Token đã được cấp. [Hướng dẫn toàn bộ luồng](/docs/oauth/quickstart/). Code mẫu cURL, Node.js và PHP nằm dưới form Playground.

## Lỗi cần xử lý

`invalid_client` hoặc `invalid_grant` khi thông tin ứng dụng/code/token không hợp lệ. Xem [bảng lỗi](/docs/oauth/errors/).


## Request và response tham khảo

Các mẫu dưới đây giữ cấu trúc trường và kiểu dữ liệu. Khóa, chữ ký, URL phiên đã được thay bằng placeholder; danh sách chỉ giữ tối đa hai phần tử và dữ liệu ảnh/PDF/XML dài được rút gọn. Không sao chép placeholder để gọi API thật.

### OAuth · Thu hồi kết nối

<div class="doc-api-actions" data-doc-api-actions><a class="try-button" data-doc-playground href="/playground/?api=oauth-revoke">Thử API trong Playground ↗</a><a class="try-button experience-button" data-doc-experience hidden>Trải nghiệm ↗</a></div>

**Đối chiếu mã nguồn backend; giá trị minh họa.** Body form-urlencoded. token là access token hoặc refresh token của ứng dụng. Thu hồi toàn bộ kết nối chứa token, dừng các token và webhook liên quan. Token không tồn tại hoặc không thuộc ứng dụng vẫn trả success, không tiết lộ thông tin.

`POST /api/v1/oauth/revoke`

Các giá trị form-urlencoded (minh họa dạng object, không gửi JSON):

```json
{
  "client_id": "",
  "client_secret": "",
  "token": ""
}
```

HTTP 200. Response:

```json
{
  "success": true
}
```