Pay2S

Appearance

🧠 Khái niệm & Tích hợp Hook Pay2S ​

🔌 Tích hợp nhanh chóng ​

Việc tích hợp cực kỳ đơn giản với PHP, Node.js hoặc bất kỳ ngôn ngữ nào.
Bạn chỉ cần khai báo đầu nhận dữ liệu (endpoint) và xử lý kết quả được Pay2S gửi về.

🏦 Liên kết tài khoản ​

Bạn cần có tài khoản Pay2S và liên kết ít nhất một tài khoản ngân hàng.
Truy cập trang quản trị để xem danh sách tài khoản liên kết.

Giao diện liên kết ​

Hệ thống có thể hỗ trợ liên kết cùng lúc nhiều tài khoản. Việc tích hợp gần như không phụ thuộc vào việc bạn liên kết tài khoản nào vào hệ thống nhờ tính linh động của hệ thống Hook.

⚙️ Tạo Hook ​

Sau khi liên kết tài khoản, bạn tiến hành khai báo Hook – là endpoint của bạn để nhận dữ liệu giao dịch.

Chi tiết vui lòng tham khảo ở mục Tạo Hook !

Thông báo giao dịch và debug lỗi ​

Các giao dịch được gửi riêng lẻ 1-1, nghĩa là nếu bạn có 5 giao dịch thì Pay2S sẽ gửi 5 lần dữ liệu giao dịch qua endpoint bạn khai báo.

Bạn có thể theo dõi dữ liệu trả về từ endpoint của bạn ở mục Thông báo để dễ dàng debug nếu muốn.

👉 Chi tiết xem tại: Tạo Hook

📩 Cơ chế gửi giao dịch ​

  • Mỗi giao dịch được gửi riêng lẻ, ví dụ có 5 giao dịch sẽ gửi 5 lần.
  • Bạn có thể theo dõi các yêu cầu tại mục Lịch sử giao dịch trên hệ thống để dễ dàng debug.

Tips:

Để test nhanh tích hợp, chỉ cần tạo một giao dịch → vào mục Lịch sử giao dịch để xem dữ liệu được gửi đến endpoint.

🔐 Bảo mật với Apikey ​

  • Dữ liệu được gửi ở định dạng JSON (raw body)
  • Header kèm theo: Authorization: Bearer [SecretKey của Hook]

WARNING

SecretKey được gửi kèm trong Header của request tên là Authorization Bearer do đó để bảm bảo dữ liệu được gửi từ Pay2S thì bạn nên kiểm tra và so sánh SecretKey này trước khi xử lý dữ liệu giao dịch trên hệ thống của mình.

📦 Dữ liệu giao dịch gửi về từ Pay2S ​

Dưới đây là các trường được gửi từ hệ thống:

id
gateway
transactionDate
transactionNumber
accountNumber
content
transferType
transferAmount
checksum
id

id

Mã định danh duy nhất tại Pay2S

gateway

Đây là tên cổng thanh toán của tài khoản liên kết (momo, vcb, techcombank...)

transactionDate

Đây là ngày tháng của giao dịch ở định dạng yyyy-mm-dd

transactionNumber

Đây là mã giao dịch riêng biệt và không trùng với các giao dịch khác trên cùng 1 tài khoản liên kết của bạn. Nghĩa là sẽ không thể có 2 giao dịch cùng mã này trên cùng một cổng thanh toán.

accountNumber

Đây là số tài khoản liên kết nhận giao dịch

content

Đây là nội dung của giao dịch mà bạn nhận được từ các cổng thanh toán

transferType

Đây là định danh cho loại giao dịch (nhận tiền hoặc chuyển tiền).

- IN: Nhận tiền
- OUT: Chuyển tiền

transferAmount

Đây là số tiền giao dịch, số tiền này ở dạng số nguyên không chứa ký tự phân cách (,.) hàng đơn vị. Ví dụ: 1000000

checksum

Mã duy nhất theo giao dịch được sinh ra từ Pay2S để xác định giao dịch này là duy nhất.