# Tích hợp Haravan

## Hướng dẫn lấy API Key từ Haravan

**Bước 1: Truy cập vào admin**

Truy cập vào **admin** trên trang Haravan web của bạn => **Ứng dụng** => **Ứng dụng riêng**

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

**Bước 2: Tạo Ứng dụng và cấu hình Ứng dụng**

Nhập thông tin Tên ứng dụng + email của bạn và **cho phép quyền đọc ghi trên đơn hàng.**

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

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

Sau khi tạo xong ta được giao diện Ứng dụng như dưới đây:

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

## Cấu hình tích hợp Haravan trên BankMate

* Truy cập BankMate rồi vào **Ứng Dụng** => chọn **Haravan -> Thêm mới**

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

Diền đầy đủ các thông tin vào form tích hợp, bao gồm

* Tên kết nối: tên mô tả cho ứng dụng kết nối
* Loại giao dịch: chọn giao dịch thu
* Apikey nhập thông tin ứng dụng đã tạo ở bước 2
* Tiền tố đơn hàng: Tiền tố là các kí tự sẽ cộng với mã đơn hàng khi thanh toán. Ví dụ mã đơn hàng là 1234 và tiền tố là DH => Nội dung thanh toán là **DH1234.** Nên điền trường trường này >=2 kí tự và <=10 kí tự (in hoa) để thuận tiện cho quá trình xác nhận thanh toán.
* Ngân hàng kết nôi: chọn 1 ngân hàng để nhận tiền thanh toán đơn hàng
* Bấm kết thúc để lưu kết nối tới Haravan

Sau khi tạo kết nối tới Haravan ta có 1 đoạn mã Script này, bạn copy đoạn mã này lại

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

## Thiết lập trang thanh toán trên Haravan

* Vào trang **Admin của Haravan** => **Cấu hình** => **Phương thức thanh toán**. Ở đây ta chọn  "Phương thức thanh toán tuỳ chọn" -> nhập tên phước thức thanh toán -> kích hoạt

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

Quay lại phần **Cài đặt** => vào **Thanh toán**. Ở mục xử lý đơn hàng ta dán đoạn code BankMate đã đã sao chép ở bước trên vào trường Nội dung thông báo thêm và Lưu lại.

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

Sau khi hoàn tất các bước cài đặt trên thì hệ thống thanh toán tự động đã hoàn tất

&#x20;

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


---

# 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.bankmate.vn/tich-hop/tich-hop-cong-thanh-toan/tich-hop-haravan.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.