Pay2S

Appearance

📦 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 ​

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ếnVí dụMô tả
base_urlhttps://api-partner.pay2s.vnBase URL Partner API
access_keyPAY2SXXXXXXXX...Lấy từ my.pay2s.vn (Partner)
secret_keySECRETXXXXXXXX...Lấy từ my.pay2s.vn (Partner)
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.