# Hướng dẫn chi tiết tích hợp SePay

#### Mô tả tính năng

Tính năng thanh toán qua Sepay trên Hoola.vn cho phép website:

* **Tạo mã QR động:** Tự động hiển thị mã QR kèm nội dung chuyển khoản chính xác (số tiền, nội dung) cho từng đơn hàng, giúp khách hàng thanh toán nhanh chóng và tiện lợi chỉ bằng cách quét mã QR qua ứng dụng ngân hàng.
* **Tự động xác nhận thanh toán:** Sepay sẽ theo dõi giao dịch và thông báo về website Hoola khi có một khoản thanh toán khớp với thông tin đơn hàng.
* **Tự động kích hoạt đơn hàng:** Dựa trên thông báo từ Sepay, Hoola sẽ tự động chuyển trạng thái đơn hàng từ "Chờ thanh toán" sang "Đã thanh toán" hoặc "Đã kích hoạt", loại bỏ nhu cầu kiểm tra thủ công và giúp đẩy nhanh quá trình xử lý đơn hàng.
* **Quản lý giao dịch tập trung:** Tất cả các giao dịch và trạng thái đơn hàng được đồng bộ, giúp dễ dàng theo dõi và quản lý doanh thu.

#### Các hành động chính trong hướng dẫn

Trong hướng dẫn này, người dùng sẽ thực hiện các bước sau:

1. **Đăng ký và kết nối ngân hàng với Sepay:** Thiết lập tài khoản Sepay cơ bản.
2. **Kích hoạt và lấy Mã tích hợp (Token) trên Hoola:** Bật tính năng Sepay và lấy khóa API cần thiết.
3. **Cấu hình Webhook trên Sepay:** Liên kết Sepay với Hoola để tự động cập nhật trạng thái đơn hàng.
4. **Kiểm tra và hoàn tất:** Xác minh lại toàn bộ quy trình để đảm bảo hoạt động trơn tru.

***

## Bước 1. Đăng ký tài khoản và kết nối ngân hàng với Sepay

Đầu tiên, cần có tài khoản Sepay và đã kết nối tài khoản ngân hàng với Sepay để có thể nhận thanh toán.

* **Hướng dẫn đăng ký tài khoản Sepay:** Vui lòng truy cập [https://docs.sepay.vn/dang-ky-sepay.html](https://www.google.com/url?sa=E\&q=https%3A%2F%2Fdocs.sepay.vn%2Fdang-ky-sepay.html) để xem các bước đăng ký tài khoản chi tiết.
* **Hướng dẫn kết nối tài khoản ngân hàng với Sepay:** Sau khi có tài khoản Sepay, cần thêm tài khoản ngân hàng để có thể nhận tiền từ các giao dịch. Truy cập [https://docs.sepay.vn/them-tai-khoan-ngan-hang.html](https://www.google.com/url?sa=E\&q=https%3A%2F%2Fdocs.sepay.vn%2Fthem-tai-khoan-ngan-hang.html) để xem hướng dẫn chi tiết.

## Bước 2. Kích hoạt tự động qua Sepay trên Hoola.vn

Sau khi đã có tài khoản Sepay và kết nối ngân hàng, cần kích hoạt tính năng Sepay trên Hoola và lấy mã tích hợp để cấu hình trên Sepay.

1. **Truy cập mục Cài đặt Thanh toán trên Hoola:**
   * Đăng nhập vào trang quản trị website Hoola.
   * Vào mục **Cài đặt hệ thống** → **Thanh toán**.
2. **Kích hoạt Tự động qua Sepay:**
   * Trong phần **Thanh toán chuyển khoản**, người dùng sẽ thấy mục **Tự động kích hoạt qua SePay**.
   * Click tích chọn để bật tính năng này.

<figure><img src="/files/YhezcozbRm3ukCbdEFfO" alt=""><figcaption></figcaption></figure>

**Cấu hình thông tin ngân hàng:**

* **Chọn ngân hàng:** Chọn ngân hàng đã kết nối với Sepay.
* **Số tài khoản:** Nhập số tài khoản ngân hàng.
* **Tên tài khoản:** Nhập tên chủ tài khoản ngân hàng.

{% hint style="info" %}
Lưu ý: Tên và số tài khoản cần trùng khớp với tên trên tài khoản Sepay và ngân hàng.
{% endhint %}

{% hint style="success" %}
**Cài đặt các tùy chọn khác:**

* **Sử dụng tiền tố trước mã chuyển khoản:** **Yêu cầu Bật** để  thêm tiền tố vào mã chuyển khoản - Đồng bộ phần Cấu hình chung với Sepay.
  * **Tiền tố:** Nhập tiền tố mong muốn (ví dụ: ARN), từ 2 đến 5 ký tự.
  * **Độ dài mã sau tiền tố:** Thiết lập độ dài của phần mã sau tiền tố.
* **Thay đổi nội dung ghi chú:** Bật nếu muốn tùy chỉnh nội dung ghi chú khi khách hàng chuyển khoản.
* **Thời gian thực hiện thanh toán (phút):** Đặt thời gian giới hạn cho khách hàng hoàn tất thanh toán (nên sử dụng để kích thích thanh toán).
  {% endhint %}

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

Bước này vô cùng quan trọng để Hoola có thể tự động cập nhật trạng thái đơn hàng khi khách hàng thanh toán thành công qua Sepay.

1. **Đăng nhập vào tài khoản Sepay:** Truy cập trang quản trị Sepay \[<https://my.sepay.vn/login>]
2. **Tìm đến mục Webhook:** Truy cập mục **`Tích hợp Webhooks`** .<br>

   <figure><img src="/files/utgqsPPFP9LZNqetIZtP" alt=""><figcaption></figcaption></figure>
3. **Thêm Webhook mới:**

<figure><img src="/files/Fn3qOEsEznKGAaFQbwOB" alt=""><figcaption></figcaption></figure>

Điền đầy đủ thông tin, bao gồm:

* **Đặt tên:** Người dùng đặt tên bất kỳ
* **Chọn sự kiện:** Sự kiện Bắn WebHooks khi `Có tiền vào`.
* **Chọn điều kiện:** Bao gồm:
  * **Khi tài khoản ngân hàng là:** Chọn tài khoản mà khi có giao dịch, webhooks sẽ bắn. \
    Lưu ý: Chọn tài khoản tương ứng với thông tin tài khoản đặt trên website tạo từ Hoola.\
    Trong trường hợp bạn muốn chỉ định các tài khoản ảo (VA) cụ thể để nhận thông báo, tích vào hộp kiểm Lọc theo tài khoản ảo và chọn các tài khoản ảo cần theo dõi (bỏ qua nếu không cần thiết).
  * **Bỏ qua nếu nội dung giao dịch không có Code thanh toán?:** Chọn `Có`.\
    Mục đích: SePay sẽ KHÔNG bắn webhooks nếu không nhận diện được code thanh toán trong nội dung thanh toán.\
    ‼️ **QUAN TRỌNG: Cấu hình nhận diện code thanh toán tại phần** `Công ty → Cấu hình chung → Cấu trúc mã thanh toán`.\
    **Tiền tố:** tương ứng với tiến tố bên website tạo từ Hoola.\
    **Hậu tố:** chính là độ dài mã sau tiền tố bên website tạo từ Hoola, để khoảng tương ứng trong độ dài đặt bên website. Lưu ý: Đặt **Số và chữ**.\
    Chuyển `Đang hoạt động` và `Lưu lại`.<br>

    <figure><img src="/files/JHZOmcUoKpHc4iA2d96q" alt=""><figcaption></figcaption></figure>
* **Thuộc tính WebHooks:** Bao gồm:
  * **Gọi đến URL:** Đường link muốn gọi WebHooks. \ <mark style="color:purple;">**Định dạng: https\://{domain\_website}/api/sepay\_verify**</mark>\
    Ví dụ:\
    <https://demo.hoola.vn/api/sepay\\_verify>  \
    <https://www.tenmiencuaban.com/api/sepay\\_verify> &#x20;
  * **Là WebHooks xác thực thanh toán?**: Chọn `Đúng`.
  * **Gọi lại WebHooks khi?**: Không tích chọn.
* **Cấu hình chứng thực WebHooks:** Bao gồm:
  * **Kiểu chứng thực:** Chọn `API Key`.
  * **Request Content:** Chọn `application/json`.
  * **Mã tích hợp (Token):** Dán **Token** đã copy từ mục **Mã tích hợp** trên Hoola vào đây.<br>

    <figure><img src="/files/DsQhAnoDFDGlOKr93TUc" alt=""><figcaption></figcaption></figure>

4. **Lưu cấu hình Webhook:** Sau khi điền đầy đủ thông tin, hãy lưu lại cấu hình Webhook trên Sepay.

## Bước 4. Kiểm tra và Hoàn tất

Sau khi hoàn tất các bước trên, hệ thống thanh toán Sepay đã sẵn sàng hoạt động.

* Có thể tạo một đơn hàng thử nghiệm trên website Hoola, chọn phương thức thanh toán qua Sepay để kiểm tra xem quá trình tạo mã QR, thanh toán và tự động cập nhật trạng thái đơn hàng có diễn ra chính xác không.
* Khi có đơn hàng được thanh toán thành công qua Sepay, hệ thống Hoola sẽ tự động nhận diện và kích hoạt đơn hàng, màn hình thanh toán của học viên tự động chuyển sang giao diện các khoá học, giúp quản lý bán hàng hiệu quả hơn.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hoola.vn/v5.0.0/huong-dan-cai-dat-website/huong-dan-cai-dat-he-thong/thanh-toan/huong-dan-chi-tiet-tich-hop-sepay.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.