🪝 Tạo Hook

🔐 Token là gì?

Token được tạo một lần duy nhất trong quá trình khai báo Hook trên hệ thống Pay2S.vn. Token giúp xác minh rằng dữ liệu giao dịch được gửi từ Pay2S là chính xác và hợp lệ.

Định dạng Token

{ 'Content-Type: application/json', 'Authorization: Bearer token' }

❗ Lưu ý

Token này chỉ được hiển thị duy nhất một lần khi bạn tạo Hook.

🛠️ Cách tạo Webhook

1️⃣ Đầu tiên các bạn truy cập vào khu vực Webhooks -> Thêm webhook -> Thêm sẽ thấy giao diện như sau:

2️⃣ Các tham số cần nhập khi tạo Hook:

- Chọn tài khoản thêm Webhook
- Chọn sự kiện
- Nhập webhook Endpoint

🔎 Mô tả chi tiết các thành phần

Chọn tài khoản thêm Webhook

Đây là mục cho phép bạn chọn tài khoản muốn Hook gửi dữ liệu giao dịch đi sang hệ thống khác. Tài khoản này được thêm ở phần Liên kết trên hệ thống Pay2S.

Nghĩa là bạn cần phải liên kết tài khoản trước khi chuyển qua bước Tạo Hook này !

🔔 Chọn sự kiện

Bạn có thể chọn sự kiện giao dịch mà hệ thống sẽ gửi sang endpoint:. Dữ liệu này có thể là:

• Gửi và nhận (tất cả sự kiện)
• Nhận tiền
• Chuyển tiền

🌐 Endpoint

Là địa chỉ sẽ nhận dữ liệu được Pay2S gửi tới theo điều kiện thiết lập. Bạn có thể chỉ định tùy ý đầu nhận dữ liệu ở mục này.

TTùy thuộc vào website của bạn có sử dụng SSL hay không mà lựa chọn http hoặc https cho phù hợp!

🔁 Chu kỳ gửi dữ liệu

⏱️ Gửi lại tự động nếu lỗi

• Gửi ngay lập tức khi có phát sinh dữ liệu.
• Gửi lại sau 60s nếu phản hồi chưa thành công hoặc lỗi từ địa chỉ nhận dữ liệu.
• Gửi tối đa 6 lần.

📭 Điều kiện dừng gửi lại

Ngoài việc phản hồi mã HTTP 200, hệ thống Pay2S sẽ ngừng gửi lại webhook nếu body phản hồi chứa:

{
  "success": true
}

📌 Sau khi tạo xong, bạn có thể test bằng cách thực hiện một giao dịch thử và kiểm tra dữ liệu trong mục Thông báo để xác nhận hệ thống đã nhận đúng Hook.