Xóa webhook

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

# Xóa webhook

`DELETE https://api.pay2s.vn/api/v1/oauth/webhooks/{id}`

## Xác thực

Bearer. Scope cần có: `webhooks:delete`. Gửi header `Authorization: Bearer ACCESS_TOKEN`.

## Tham số

Định dạng: **tham số path, không có body**.

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

id trong đường dẫn gồm đúng 64 ký tự hex. Không gửi body. Xóa webhook thuộc kết nối hiện tại, giải phóng slot webhook; ngừng chuyển tiếp các lần retry đang chờ. Request đã gửi trước khi xóa có thể vẫn hoàn tất.

Cần gói Pay2S còn hoạt động. Dữ liệu chỉ thuộc tài khoản/ngân hàng được cấp quyền; tài khoản demo chỉ đọc ngân hàng và giao dịch demo.

## 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_token` (401), `insufficient_scope` hoặc `active_plan_required` (403), dữ liệu không hợp lệ (422). 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 · Xóa webhook

<div class="doc-api-actions" data-doc-api-actions><a class="try-button" data-doc-playground href="/playground/?api=oauth-webhooks-delete">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.** id trong đường dẫn gồm đúng 64 ký tự hex. Không gửi body. Xóa webhook thuộc kết nối hiện tại, giải phóng slot webhook; ngừng chuyển tiếp các lần retry đang chờ. Request đã gửi trước khi xóa có thể vẫn hoàn tất.

`DELETE /api/v1/oauth/webhooks/{id}`

Tham số path/query (không gửi JSON body):

```json
{
  "id": ""
}
```

HTTP 200. Response:

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