Nhảy tới nội dung

Bắt đầu

Chào mừng bạn đến trang tài liệu của payOS.

Hướng dẫn lập trình viên tích hợp payOS để xử lý giao dịch Thanh toán chuyển khoản Napas 24/7 của khách hàng.

payOS-Hosted pagepayOS-Hosted page
Xây dựng trang thanh toán hoặc sử dụng trang thanh toán có sẵn của payOS
payOS embeddedpayOS embedded
Nhúng giao diện thanh toán vào ứng dụng hoặc website của bạn

Clone code mẫu​

Bạn có thể tham khảo một số dự án mã nguồn mở của payOS tại GitHub payOSHQ.

payOS ReactJS example
Github banner
Web
payOS Java spring example
Github banner
Backend

Luồng hoạt động​

  • Bước 1: Khách hàng thực hiện mua hàng trên Website hoặc ứng dụng của merchant và lựa chọn thanh toán trực tuyến Napas 247 cho đơn hàng.
  • Bước 2: Website hoặc ứng dụng của merchant tiến hành gọi tạo link thanh toán, payOS sẽ kiểm tra dữ liệu và trả về kết quả chứa link thanh toán. Khi hệ thống của merchant nhận kết quả link thanh toán cần chuyển hướng khách hàng của bạn đến trang checkout của payOS bằng cách mở link thanh toán từ kết quả.
  • Bước 3: Khách hàng sử dụng ứng dụng ngân hàng để quét mã VietQR từ link thanh toán.
  • Bước 4: Giao dịch ghi nhận thành công tại ngân hàng, payOS sẽ trả kết quả thành công về returnUrl gồm: trạng thái, mã đơn hàng, mã link thanh toán, ... Từ kết quả nhận được trên returnUrl Website hoặc ứng dụng của merchant hiển thị giao diện thành công.
  • Bước 5: Sau khi có kết quả ở giao diện, đồng thời payOS sẽ gửi một kết quả với đầy đủ thông tin thanh toán tới Webhook của cửa hàng được thiết lập trên https://my.payos.vn, sau đó merchant cập nhật trạng thái đơn hàng phù hợp.
thông tin

Chi tiết API tạo link thanh toán

Chi tiết dữ liệu gửi đến webhook của merchant

Cách tích hợp payOS với hệ thống của Merchant​

Chương trình đối tác tích hợp​

"Đối tác tích hợp" là chương trình tiếp thị liên kết (Affiliate Marketing) dành cho các lập trình viên, nhà phát triển khi tích hợp cổng thanh toán payOS vào Web/App của doanh nghiệp/khách hàng, qua đó giúp hàng triệu Website tiếp cận giải pháp cổng thanh toán không qua trung gian.

  • Chiết khấu 100đ/giao dịch

Chi tiết thông tin chương trình

Rate limits​

Để đảm bảo dịch vụ ổn định, payOS API xác định giới hạn truy cập trên mỗi lần gọi.

Nếu thực hiện quá nhiều yêu cầu cùng một lúc, thì bạn sẽ nhận một kết quả HTTP là 429 Too Many Requests