Postman Collection – Pay2S Partner API

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

# 📦 Postman Collection – Pay2S Partner API

Tải về và import **Postman Collection** để thử nhanh các API của **Pay2S Partner** (Authentication, Banks, Webhook, Analytics).  
Bộ sưu tập này khớp với tài liệu và các route hiện hành.

---

## ⬇️ Tải xuống

- **Collection (.json):** [pay2s-partner.postman_collection.json](https://docs.pay2s.vn/downloads/pay2s-partner.postman_collection.json)

> Sau khi tải về, mở Postman → `Import` → chọn file `.json` này.

---

## 🔧 Biến môi trường gợi ý (Environment)

Bạn có thể tạo **Environment** trong Postman với các biến sau để tiện sử dụng:

| Biến | Ví dụ | Mô tả |
|---|---|---|
| `base_url` | `https://api-partner.pay2s.vn` | Base URL Partner API |
| `access_key` | `PAY2SXXXXXXXX...` | Lấy tại [merchant.pay2s.vn](https://merchant.pay2s.vn) → Bankhub → thiết lập |
| `secret_key` | `SECRETXXXXXXXX...` | Lấy tại [merchant.pay2s.vn](https://merchant.pay2s.vn) → Bankhub → thiết lập |
| `bearer_token` | *(để trống, sẽ set sau)* | Token trả về từ `/v1/auth/authorize` |

---

## 🚀 Quy trình dùng nhanh

1. Mở request **Authorize** trong folder **Authentication**.
2. Đặt header `Authorization: Basic base64(access_key:secret_key)`.
3. Send để nhận `token` → copy vào **Environment**: `bearer_token`.
4. Dùng các request còn lại (Banks, Webhooks, Metrics) với header:
   ```
   Authorization: Bearer {{bearer_token}}
   ```

---

## 🧪 Mẹo test nhanh

- Có sẵn các request:
  - `POST https://api-partner.pay2s.vn/v1/auth/authorize` – Lấy token
  - `POST https://api-partner.pay2s.vn/v1/banks` – Thêm ngân hàng (OpenAPI ACB/BIDV, personal, business)
  - `POST https://api-partner.pay2s.vn/v1/banks/confirm-otp` – Xác nhận OTP
  - `GET https://api-partner.pay2s.vn/v1/banks` – Danh sách
  - `DELETE https://api-partner.pay2s.vn/v1/banks/:id` & `POST /v1/banks/:id/delete-confirm` – Xoá & xác nhận
  - `GET https://api-partner.pay2s.vn/v1/webhooks` / `POST /v1/webhooks` – Quản lý webhook
  - `GET https://api-partner.pay2s.vn/v1/webhooks/history` – Lịch sử gọi webhook
  - `POST https://api-partner.pay2s.vn/v1/webhooks/:history_id/resend` – Gửi lại payload
  - `GET https://api-partner.pay2s.vn/v1/metrics/*` – Thống kê

- Nếu bị **401 Unauthorized**, hãy kiểm tra lại token hết hạn (mặc định 3600s).

---

## 🧯 Lỗi hay gặp

- **OTP không hợp lệ**: OTP có thời hạn, thử gửi lại OTP và xác nhận ngay.

---

Chúc bạn tích hợp thành công! Nếu cần hỗ trợ, truy cập **Trung tâm khách hàng** hoặc mục **Hỗ trợ & Báo lỗi** trong thanh điều hướng.