Skip to content

🧩 Tích hợp kỹ thuật

🔑 Thông tin tích hợp

Pay2S cung cấp bộ mã định danh dùng để tích hợp hệ thống:

  • Partner Code: Định danh duy nhất cho tài khoản Pay2S của bạn.
  • Access Key: Mã dùng để cấp quyền truy cập API.
  • Secret Key: Khoá bí mật dùng để tạo digital signature trong quá trình xác thực yêu cầu.

⚠️ Bảo mật: Không chia sẻ Access Key và Secret Key cho bất kỳ ai. Bạn nên lưu trữ các thông tin này ở nơi an toàn và chỉ dùng trên server backend.

Tích hợp kỹ thuật


⚙️ Cấu hình HTTP Request

KeyValue
Content-Typeapplication/json; charset=UTF-8
MethodPOST
DomainProduction: https://payment.pay2s.vn

🧾 Mã giao dịch Pay2S (trans_id)

Mỗi giao dịch tại Pay2S được gán một mã giao dịch duy nhất (trans_id).
Đây là mã do hệ thống Pay2S tự sinh và dùng để truy vết, kiểm tra và đối soát giao dịch.


📦 Mã đơn hàng đối tác (orderId / billId)

Đây là mã giao dịch bạn tự định nghĩa bên phía hệ thống của mình để xác định đơn hàng.

Quy định đặt mã đơn hàng:

  • Không được để trống
  • Không vượt quá 64 byte
  • Không chứa thông tin bí mật hoặc nhạy cảm

orderId/billId nên mang ý nghĩa định danh rõ ràng và có thể liên kết tới đơn hàng trong hệ thống của bạn.


🎯 Tiếp theo: Cách tạo chữ ký số (Signature)