Khái niệm

Tích hợp

Việc tích hợp cực kỳ đơn giản với PHP, Nodejs hay bất kỳ mã nguồn nào khác. Bạn chỉ cần khai báo đầu nhận dữ liệu và đón kết quả được trả về từ Pay2S sau đó xử lý dữ liệu giao dịch này trên hệ thống của bạn.

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

Đầu tiên bạn cần có tài khoản và liên kết được tài khoản lên hệ thống Pay2S. Vui lòng xem trong danh sách liên kết trong menu quản trị hệ thống (danh sách hỗ trợ sẽ được update hoặc thay đổi bất kỳ lúc nào)

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 thành công, bạn tiến hành tạo Hook để khai báo việc gửi dữ liệu giao dịch qua endpoint mà bạn muốn.

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.

Tips:

Thông thường để kiểm tra quá trình tích hợp có thành công hay không, bạn chỉ cần tạo một giao dịch cho tài khoản liên kết và chờ kết quả debug ở phần Thông báo được trả về.

Dữ liệu gửi đi từ Pay2S

Các tham số cơ bản của một giao dịch được gửi theo dạng json (raw text) kèm theo Token mà bạn đã khai báo ở bước Tạo Hook.

WARNING

SecretKey được gửi kèm trong Header của request tên là Apikey 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.

Sau đây là dữ liệu được gửi từ Pay2S:

id
gateway
transactionDate
transactionNumber
accountNumber
content
transferType
transferAmount
checksum

checksum

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