Danh sách ngân hàng

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

# Danh sách ngân hàng

`GET https://api.pay2s.vn/api/v1/oauth/bank-accounts`

## Xác thực

Bearer. Scope cần có: `accounts:read`. Gửi header `Authorization: Bearer ACCESS_TOKEN`.

## Tham số

Định dạng: **query URL**.

Không có tham số request.

Chỉ trả ngân hàng được cấp quyền, đang hoạt động và không bị ẩn. Tài khoản demo chỉ được nhận ngân hàng demo. ID/số tài khoản có thể là chuỗi theo dữ liệu MySQL; giữ số tài khoản dạng chuỗi.

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 · Danh sách ngân hàng

<div class="doc-api-actions" data-doc-api-actions><a class="try-button" data-doc-playground href="/playground/?api=oauth-bank-accounts">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.** Chỉ trả ngân hàng được cấp quyền, đang hoạt động và không bị ẩn. Tài khoản demo chỉ được nhận ngân hàng demo. ID/số tài khoản có thể là chuỗi theo dữ liệu MySQL; giữ số tài khoản dạng chuỗi.

`GET /api/v1/oauth/bank-accounts`

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

```json
{}
```

HTTP 200. Response:

```json
{
  "data": [
    {
      "id": 123,
      "accountNumber": "P2S99999999",
      "vaNumber": "",
      "bankName": "ACB",
      "shortBankName": "ACB"
    }
  ]
}
```