Danh sách ngân hàng hỗ trợ

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

# Danh sách ngân hàng hỗ trợ

Endpoint từng được tài liệu ghi là `POST https://payment.pay2s.vn/v1/gateway/api/bankcodes`.

**Kiểm tra ngày 11/10/2026: endpoint trả HTTP 404 và không trả JSON danh sách ngân hàng.** Chưa có endpoint thay thế được xác minh; không dùng response mẫu cũ như hợp đồng API đang hoạt động.

Khi tạo thanh toán, truyền `bank_id` và `account_number` của tài khoản đã liên kết. Tài khoản demo đang cấu hình dùng `ACB` và `P2S99999999`.

Đối với Hosted Link, để giao diện Hosted Link tải danh sách ngân hàng theo cấu hình app; `/v1/banks` là danh sách tài khoản đã liên kết của Partner, không phải danh mục mọi ngân hàng hỗ trợ.


## Request và response đối chiếu ngày 11/10/2026

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.

### Danh sách ngân hàng hỗ trợ

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

**Đã gọi API demo/UAT.** Lần kiểm tra này upstream trả HTTP 404, không có response danh sách ngân hàng thành công để xác minh.

`POST /v1/gateway/api/bankcodes`

Body:

```json
{}
```

HTTP 404. Response do Playground báo khi upstream không trả JSON:

```json
{
  "success": false,
  "error": {
    "code": "UPSTREAM_NON_JSON",
    "message": "API trả HTTP 404 với nội dung không phải JSON."
  }
}
```