Tích hợp Sapo
Mỗi khi phát sinh một giao dịch mới, dựa trên mã đơn hàng và số tiền người dùng đã chuyển, ThueAPI sẽ tự động xác nhận thanh toán và chuyển trạng thái đơn hàng trực tiếp trên website Sapo.
Hướng dẫn lấy Token (API Key) từ Sapo
Truy cập vào khu vực quản trị Sapo sau đó chọn Ứng dụng
> Ứng dụng riêng
Chọn mục Tạo ứng dụng riêng
Đặt tên cho ứng dụng và email liên hệ của bạn. Kéo xuống phía dưới mục Đơn hàng, giao dịch và vận chuyển
chọn Đọc và ghi
sau đó bấm Lưu
để tiếp tục
Chúng ta sẽ được chuyển tới trang chứa API Key
và API Secret
.
Hãy lưu lại thông tin này để điền vào bước Tạo Hook
trên ThueAPI ở phía bên dưới
Thiết lập phương thức thanh toán tùy chỉnh
Truy cập vào Cấu hình
> Phương thức thanh toán
Kéo xuống phía dưới chọn mục Thanh toán thủ công
> Phương thức thanh toán tùy chọn
Cập nhật Tên phương thức
và Hướng dẫn thanh toán
sau đó bấm Lưu
để tiếp tục quá trình tích hợp thanh toán
Truy cập vào Cấu hình
> Trang thanh toán
Kéo xuống phía dưới phần Xử lý đơn hàng
.
Ở mục Nội dung thông báo thêm
điền vào nội dung sau:
<script src="https://XXX.thueapi.com/api/sapo/script"></script>
Ý nghĩa
Đoạn code phía trên có chứa chuỗi XXX
chính là tên miền của bạn trên ThueAPI.
Ví dụ tên miền phụ trên ThueAPI là codetay
thì bạn điền vào codetay.thueapi.com
Hướng dẫn tạo hook trên ThueAPI
Truy cập vào ThueAPI và tiến hành Tạo Hook
Provider
Chọn Sapo
để tích hợp thanh toán
Endpoint
Điền địa chỉ tên miền Sapo mà bạn đang sử dụng.
Nếu bạn muốn hiển thị cùng lúc nhiều tài khoản để người dùng dễ dàng lựa chọn tài khoản ngân hàng để thanh toán thì có thể điền dữ liệu này giống nhau.
Ví dụ tên miền trên Sapo là https://codetay.mysapo.net/
Cú pháp định danh
Đây chính là phần nội dung để xác định thanh toán cho đơn hàng.
Hệ thống sẽ tự động thêm vào phía trước mã đơn hàng. Ví dụ DH10000
Cần sử dụng các ký tự định danh càng riêng biệt càng tốt. Tránh sử dụng các tên riêng trùng với tên viết tắt của các ngân hàng ví dụ như VCB, ACB, TCB...
Nội dung đầu
Đây chính là nội dung sẽ hiển thị đầu tiên trên phần hướng dẫn thanh toán của ThueAPI
Nội dung sau khi thanh toán
Đây chính là nội dung sẽ hiển thị sau khi đơn hàng được thanh toán thành công.
API Key
Đây chính API Key của Ứng dụng riêng
mà bạn đã tạo ở phía trên.
Tên cổng thanh toán tùy chỉnh
Đây chính là tên của Phương thức thanh toán tùy chọn
mà bạn đã tạo ở phía trên
Lưu ý: dữ liệu này phải điền chính xác với tên phương thức đã tạo ở phía trên để có thể kích hoạt thanh toán với ThueAPI.
Token
Nội dung điền vào chính là API Secret
của Ứng dụng riêng
mà bạn đã tạo ở phía trên.
Sau khi tích hợp thành công, màn hình thanh toán sẽ hiển thị như phía dưới.
Ưu điểm khi tích hợp với ThueAPI:
- Có thể chọn nhiều tài khoản thanh toán cùng lúc
- Có thể copy các dữ liệu cho việc điền vào các cổng thanh toán khác
- Tự động điền số tiền và cú pháp thanh toán khi quét mã QR Code
- Tự động xác nhận thanh toán với hệ thống Sapo
- Thông báo xác nhận hiển thị ngay sau khi thanh toán thành công
Nếu tất cả các bước thiết lập chính xác, sau khi đơn hàng được thanh toán bạn sẽ nhận được thông báo xác nhận thành công!
Chúc mừng bạn đã tích hợp thành công ThueAPI với Sapo!