# Tích hợp Sapo

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

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

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

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

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

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

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/INTHiG9DfOkYxoWmBF6H" 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/Fn6piIeklH7lRiosZjF6" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/o2Q8cfMnzCA5O4EodyyW" 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
* Link Sapo: **Tên trang web.mysapo.net**
* Apikey và app secret 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 Sapo

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

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

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

* Vào trang **Admin của Sapo web** => **Cài đặt** => **Phương thức thanh toán**. Ở phần thanh toán thủ công, ta tiến hành tạo ra phương thức thanh toán tùy chọ&#x6E;**,** sửa lại tên theo ý muốn sau đó lưu lại.

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

Quay lại phần **Cài đặt** => vào **Trang 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/psfOvzzYA42DJlGdDaDt" 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/fvXhbkmUoNG2YioNqtmM" 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-sapo.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.