Sepay là gì?

Sepay là một giải pháp thanh toán tự động thông qua việc theo dõi biến động số dư và gửi API về cho dịch vụ của bạn. Ví dụ:

Người dùng có thể mua hàng trên website hoặc ứng dụng của bạn.
Họ lựa chọn phương thức thanh toán là chuyển khoản ngân hàng vào số tài khoản của bạn.
Sau khi người dùng chuyển khoản, Sepay sẽ gọi API sang dịch vụ của bạn để thông báo biến động số dư.
Bạn sẽ dựa vào nội dung chuyển khoản để xác định đơn hàng nào đã được thanh toán và tự động cập nhật trạng thái đơn hàng.

Chi tiết hơn bạn có thể tham khảo tại trang chủ của Sepay.

Cài đặt Sepay

Bạn sẽ cần triển khai ezyplatform trên một máy chủ có tên miền và sử dụng https.
Trong giao diện admin bạn sẽ tìm đến menu E-Commerce > Payment Services chọn thay đổi Sepay và điền các thông tin như sau:
Name: Sepay.
Version: 1.0.0.
Bank: Bạn hãy lựa chọn một trong những ngân hàng có liên kết với Sepay.
Currency: Bạn hãy lựa chọn tiền VNĐ.
Service URL: Bạn hãy điền: https://sepay.vn/
Service API URL: Bạn hãy điền https://sepay.vn/
Callback URL: Bạn hãy để mặc định.
Client key: Bạn hãy tạo ngẫu nhiên.
Secret key: Bạn hãy tạo ngẫu nhiên và sao chép tạm thời ra một chỗ nào đó để điền ở bước tạo webhook.
Status: Bạn lựa chọn Archived.

Đầu tiên bạn hãy đăng ký tài khoản dev tại đây sau đó liên hệ với Sepay theo số điện thoại ở chân trang để yêu cầu kích hoạt.
Sau khi tài khoản được kích hoạt, bạn sẽ có thể truy cập được vào giao diện dành cho dev.
Bạn di chuyển đến menu Cấu hình công ty > cấu hình chung sau đó điền tiền tố của cấu trúc mã thanh toán là PAY như hình dưới đây:

Tiếp theo bạn sẽ cần điền thông tin về webhook. Bạn cần di chuyển đến menu Tích hợp webhooks, lựa chọn Thêm webhooks, sau đó điền các thông tin cần thiết.

Giả sử website của của là example.com bạn có thể điền (3) Gọi đến url là là: https://example.com/payment/verify/SEPAY.
Api Key bạn hãy điền là giá trị Secret key mà bạn vừa sao chép ở trên.

Việc cài đặt cho Sepay sandbox đã xong, bây giờ bạn hãy tạo một hóa đơn bất kỳ và chọn hình thức thanh toán qua chuyển khoản.
Bây giờ hãy quay lại Sepay và giả lập một giao dịch với số tiền đúng bằng số tiền của hóa đơn đã tạo và nội dung là PAYUser[userId]Order[orderId] với userId là mã người dùng, orderId là mã đơn hàng, ví dụ PAYUser2Order2.
Kiểm tra lại xem trạng thái đơn hàng của bạn đã chuyển trạng thái thành Paid hay chưa, nếu đã chuyển thành Paid nghĩa là thành công.