Hướng dẫn tích hợp webhook Pay2S

Bài viết này Pay2S sẽ hướng dẫn bạn tích hợp webhook Pay2S vào website, nếu chưa có webhook bạn có thể xem bài viết Hướng dẫn tạo Webhook ghi nhận giao dịch từ Pay2S.

Đăng ký tài khoản và thêm ngân hàng tại Pay2S

Bước 1: Đăng ký tài khoản tại https://my.pay2s.vn/signup

Bước 2: Đăng nhập và chọn gói sử dụng phù hợp với nhu cầu của bạn tại menu Bảng giá (Khuyến khích chọn gói STARTER trở lên để có tài khoản dự phòng)

Bước 3: Thêm tài khoản ngân hàng 

  • Nhấn nút Thêm tài khoản
  • Chọn ngân hàng cần thêm
  • Nhập thông tin ngân hàng của bạn và thêm tài khoản

Thêm và tích hợp Webhook trên Pay2S

Bước 1: Vào menu Webhook, chọn Thêm webhook

Bước 2: Chọn tài khoản ngân hàng cần thêm webhook, chọn sự kiện và nhập endpoint webhook của bạn -> Nhấn Thêm webhook.

Bước 3: Kiểm tra hoạt động webhook bằng Postman

  1. Đăng ký tài khoản và cài đặt Postman xem tại bài viết Postman là gì ? Cài đặt và hướng dẫn test API với Postman
  2. Mở Postman tạo 1 truy vấn giao thức HTTP
    • Method  POST
    • Nhập endpoint đến file webhook của bạn: https://yourdomain/webhook.php
    • Tab Authorization – > chọn Auth Type Bearer Token và nhập webhook token của bạn (Vào menu Danh sách webhook, bấm vào icon chìa khóa ở cột Token để lấy token webhook)
  • Tab Headers thêm vào Content-Type: application/json
  • Tab Body nội dung mẫu bên dưới, chọn raw với kiểu dữ liệu là JSON, đây là dữ liệu Pay2S sẽ gửi đến webhook của bạn
{
  "transactions": [
    {
      "id": "1",
      "gateway": "NH TMCP A Chau",
      "transactionDate": "2024-08-19",
      "transactionNumber": "PAY2S001",
      "accountNumber": "107880993336",
      "content": "Thanh toán đơn hàng #123",
      "transferType": "invoice",
      "transferAmount": 10000.00
    }
  ]
}
  • Nhấn Send để gửi dữ liệu mẫu đến webhook của bạn
  • Kết quả thành công sẽ trả về success: true, message hiển thị tùy chỉnh trong file webhook của bạn
{
  "success": true,
  "message": "Giao dịch được xử lý và xác nhận thành công"
}

Vậy là bạn đã tích hợp webhook Pay2S vào website thành công. Nếu có thắc mắc hoặc cần hỗ trợ hãy liên hệ với Pay2S để được giải đáp nhanh chóng.

5/5 – (172 votes)

Bài viết khác