Tự động xác nhận thanh toán qua webhook

Hiện tại nhiều hệ thống cho phép sử dụng webhook để đồng bộ thông tin ghi nhận từ phía ngân hàng, qua đó tự động chuyển được trạng thái đơn hàng sang đã thanh toán

1.Xác thực với hệ thống tự triển khai

1.1 Tạo thông tin Webhook trong phần Phương thức thanh toán của LadiSales

Truy cập tài khoản LadiSales của bạn, vào mục Thiết lập -> Phương thức thanh toán -> Chuyển khoản qua ngân hàng

Bạn thiết lập các thông tin ngân hàng và tích chọn vào mục Tự động xác nhận thanh toán

Sau khi bạn tích Tự động xác nhận thanh toán, trên giao diện hiển thị ra phần thông tin : Xác nhận qua Webhook, bạn copy thông tin để bước hiện việc cài đặt trong hệ thống của bạn

1.2 Thực hiện việc setup webhook từ ladisales vào hệ thống của bạn

Với hệ thống bạn tự triển khai để kiểm soát toàn bộ thông báo biến động số dư bạn có thể xác nhận tự động đơn hàng bằng cách gửi POST Request tới Webhook API của LadiSales ( đã lấy ở bước 1 phía trên ) theo cấu trúc như sau:

{
 "gateway": "MBBank", 
 "transactionDate": "2024-09-16 21:49:56", 
 "accountNumber": "050215040819",
 "content": "LDP1301 FT24261043965465464505623 xxxx abbb", 
 "transferAmount": 5000
}

Diễn giải về các trường thông tin :

  • gateway : cổng ngân hàng bạn đang tích hợp ở bước 1, trường không bắt buộc

  • transactionDate: Ngày giao dịch, không bắt buộc

  • accountNumber :Tài khoản ngân hàng, không bắt buộc

  • content : Nội dung tin nhắn biến động số dư,bắt buộc và phải đảm bảo cú pháp đúng như trên trang thanh toán

Lưu ý : trong phần nội dung tin nhắn, nội dung ID mã đơn hàng https://prnt.sc/Z0To6-UPb97C là thông số bắt buộc phải có và yêu cầu giữ nguyên theo đúng thông tin hệ thống LadiPage và LadiSales hiển thị

  • transferAmount: Số tiền, bắt buộc

2.Sử dụng webhook bên thứ 3

Trong trường hợp bạn không xây dựng webhook, bạn có thể sử dụng nền tảng bên thứ 3 để hỗ trợ thao tác này. Hiện tại Sepay là 1 trong những nền tảng cung cấp giải phép chia sẻ biến động số dư, bạn có thể tham khảo

Để tích hợp Sepay với LadiSales, bạn thực hiện các thao tác theo hướng dẫn sau

2.1 . Tạo tài khoản SePay

Truy cập đường dẫn https://sepay.vn để đăng ký tạo thông tin tài khoản của SePay và thực hiện thao tác tích hợp với tài khoản bạn ngân hàng bạn mong muốn trong SePay

2.2 .Tạo thông tin Webhook trong phần Phương thức thanh toán của LadiSales

Truy cập tài khoản LadiSales của bạn, vào mục Thiết lập -> Phương thức thanh toán -> Chuyển khoản qua ngân hàng

Bạn thiết lập các thông tin ngân hàng và tích chọn vào mục Tự động xác nhận thanh toán

Sau khi bạn tích Tự động xác nhận thanh toán, trên giao diện hiển thị ra phần thông tin : Xác nhận qua Webhook, bạn copy thông tin để bước hiện việc cài đặt trong Sepay

2.3 .Cài đặt Webhook vào tài khoản Sepay của bạn

Điền lần lượt các thông tin trên phần setup và bấm Lưu lại dữ liệu

Đối với thông tin Webhook tạo trong phương thức thanh toán qua ngân hàng của LadiSales, bạn điền vào mục 3 trên giao diện thiết lập của SePay

Mục : Là WebHooks xác thực thanh toán, vui lòng chọn ĐÚNG để cấu hình được hoạt động

Một số lưu ý về tích hợp Sepay

  • Tài khoản ngân hàng trong mục Ngân hàng của Sepay , phải trùng với tài khoản ngân hàng bạn thiết lập trong LadiSales https://prnt.sc/AnSdYvkSzoxk

  • Ngân hàng tích hợp trong LadiSales phải là ngân hàng được Sepay hỗ trợ tính năng webhook - liên hệ Sepay để kiểm tra cụ thể thông tin này

Khi sử dụng phương thức tự động xác nhận đơn hàng qua webhook, nội dung chuyển khoản khi quét mã QR sẽ là Tiền Tố + Mã đơn hàng

PreviousTự động xác nhận thanh toán qua email hookNextKết nối API ngân hàng

Last updated