Hướng Dẫn Tích Hợp Sepay với SoNo

Hướng dẫn này sẽ giúp bạn từng bước kết nối Sepay với hệ thống SoNo để tự động cập nhật giao dịch và quản lý khoản nợ hiệu quả.

Bước 1: Tạo tích hợp mới trên SoNo

1. Truy cập vào trang tích hợp của SoNo: https://open.vietsono.com/integration.
2. Nhấn vào nút Tạo mới để bắt đầu quá trình tích hợp.
3. Trong danh sách đối tác, chọn Sepay Fintech.
4. Điền thông tin Tên Khoá theo ý muốn và nhấn Tạo.

Kết quả nhận được

Sau khi tạo thành công, hệ thống SoNo sẽ cung cấp 3 thông tin quan trọng:

• URL kết nối: Endpoint API để nhận Webhook từ Sepay.
• App ID: Mã định danh ứng dụng.
• API Key: Khoá bảo mật để xác thực kết nối.

WARNING

Những thông tin này chỉ hiển thị một lần và không thể xem lại. Vui lòng sao lưu để sử dụng trong các bước tiếp theo.

Bước 2: Đăng nhập và thiết lập tài khoản Sepay

1. Truy cập vào cổng quản lý Sepay: https://my.sepay.vn/login.
2. Nếu chưa có tài khoản, vui lòng đăng ký trên hệ thống Sepay.
3. Sau khi đăng nhập, điều hướng đến Tab Ngân Hàng hoặc truy cập trực tiếp: https://my.sepay.vn/bankaccount.
4. Thêm tài khoản ngân hàng của bạn vào hệ thống Sepay.

TIP

Việc thêm tài khoản ngân hàng giúp Sepay có thể nhận thông báo giao dịch mới và đóng vai trò trung gian chuyển tiếp dữ liệu đến SoNo.

Bước 3: Cấu hình Webhook trên Sepay

1. Truy cập vào Tab Webhooks trên Sepay hoặc truy cập trực tiếp: https://my.sepay.vn/webhooks.
2. Nhấn Thêm Webhook Mới và nhập các thông tin cần thiết:

Cấu hình Webhook

• Tên Webhook: Đặt tên dễ nhận diện, ví dụ: SoNo Transaction Hook.
• Sự kiện Webhook:
  • Chọn Bắn Webhook khi -> Có tiền vào (để thông báo khi có giao dịch mới).
• Điều kiện Webhook:
  • Chọn Khi tài khoản ngân hàng là: Chọn tài khoản ngân hàng đã thêm ở bước trước.
  • Bỏ qua nếu nội dung giao dịch không có Code thanh toán? -> Chọn Không.

Cấu hình URL nhận Webhook

• URL Webhook: Nhập URL kết nối đã nhận được từ SoNo. URL có định dạng:

  https://api.vietsono.com/webhook/sepay-incoming-transaction?app-id=****

• Là Webhook xác thực thanh toán? -> Chọn Không.
• Gọi lại Webhook khi? -> Tick chọn HTTP Status Code không nằm trong phạm vi từ 200 đến 299.

Cấu hình xác thực Webhook

• Kiểu chứng thực: Chọn API Key.
• Request Content Type: Application/json.
• API Key: Nhập Khoá bảo mật đã nhận được từ SoNo khi tạo tích hợp.

Kích hoạt Webhook

• Trạng thái: Đặt thành Kích hoạt.

Hoàn tất

Sau khi hoàn thành các bước trên, hệ thống Sepay sẽ tự động gửi thông báo giao dịch mới đến SoNo, giúp bạn quản lý khoản nợ dễ dàng và chính xác.

INFO

Nếu gặp bất kỳ vấn đề gì, vui lòng liên hệ đội ngũ hỗ trợ của SoNo.