# 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**

![Trang quan trị ứng dụng của Sapo](https://3793022392-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJWdrbQGvu13ZB9h7as%2F-Mi-dq3sAwXcLivjuD6r%2F-Mi-eiUisI48UnUbZ4r0%2Fimage.png?alt=media\&token=fcac8d22-0f05-4e1a-97ef-7aafbb80f27b)

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

![Cửa sổ tạo App cá nhân](https://3793022392-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJWdrbQGvu13ZB9h7as%2F-Mi-dq3sAwXcLivjuD6r%2F-Mi-fPzimEzdvTx2fZai%2Fimage.png?alt=media\&token=82debb54-4f7d-4bb9-b1ad-c1f96b68c174)

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.**

![Tạo ứng dụng](https://3793022392-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJWdrbQGvu13ZB9h7as%2F-Mi-dq3sAwXcLivjuD6r%2F-Mi-g9lRp9FnnI41_rD5%2Fimage.png?alt=media\&token=a25df149-be12-48c3-8d19-0624c2086acc)

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

![Giao diện ứng dụng riêng vừa tạo trên Sapo web](https://3793022392-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJWdrbQGvu13ZB9h7as%2F-Mi-dq3sAwXcLivjuD6r%2F-Mi-goc_SbIsNDtd89gV%2Fimage.png?alt=media\&token=593d700b-2230-4808-ab62-c993d85e0a58)

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

* Truy cập Casso rồi vào **Tích hợp** => chọn **Sapo**

![](https://3793022392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJWdrbQGvu13ZB9h7as%2Fuploads%2F3ExZkl4UDAPaIFsTkhyj%2FScreenshot%20\(853\).png?alt=media\&token=02f06980-be5f-4ae6-903f-0a3bb955e51e)

* Lần lượt ta chọn ngân hàng cần theo dõi biến động giao dịch và điền thông tin tương ứng vào cửa sổ tích hợp mà Sapo đã cung cấp khi ta tạo ứng dụng ở bước trên:

![](https://3793022392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJWdrbQGvu13ZB9h7as%2Fuploads%2FfIoJRojjC3cyawBBsoZp%2FScreenshot%20\(857\).png?alt=media\&token=0f058169-2d52-44bc-b60e-05babba039e9)

{% hint style="info" %}
Tên miền phải điền dưới dạng **Tên trang web.mysapo.net,** và chỉ chọn một tài khoản ngân hàng để tích hợp Sapo.

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.
{% endhint %}

Cuối cùng, Bấm **Gọi thử**, nếu thành công thì **Lưu tích hợp.**

![Code để hiện mã thanh toán](https://3793022392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJWdrbQGvu13ZB9h7as%2Fuploads%2FqfgUFduKdp3SG3Okhfz4%2FScreenshot%20\(858\).png?alt=media\&token=4204e9f0-3ecf-464c-9227-8cffe49b4b97)

## 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.

**Lưu ý:** Tên phương thức thanh toán cần có chữ **VietQR** để hệ thống tự động nhận diện và cập nhật mã VietQR khi thanh toán.

![Tạo phương thức thanh toán mới](https://3793022392-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJWdrbQGvu13ZB9h7as%2F-Mi-dq3sAwXcLivjuD6r%2F-Mi-lfC7rC-eAPJN6G6r%2Fimage.png?alt=media\&token=d6a8c21d-e056-4bf3-b75f-07864c595f7e)

* 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 Casso đã đã 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.

![Thêm code giao diện trang thanh toán](https://3793022392-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJWdrbQGvu13ZB9h7as%2F-Mi-dq3sAwXcLivjuD6r%2F-Mi-mIwMqDL2vi2N1Boe%2Fimage.png?alt=media\&token=02d683c2-58a7-40e5-a20d-c646dfd04d3a)

* Vậy là đã hoàn tất toàn bộ các bước thiết lập, hãy cùng kiểm tra lại kết quả thôi nào:

![Giao diện checkout của Sapo](https://3793022392-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJWdrbQGvu13ZB9h7as%2F-Mi-dq3sAwXcLivjuD6r%2F-Mi-mvmkYbBPX2lXLPYW%2Fimage.png?alt=media\&token=ad220b11-0971-4f57-91ea-0ead941c9b57)

![Thanh toán đơn hàng](https://3793022392-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJWdrbQGvu13ZB9h7as%2F-Mi-dq3sAwXcLivjuD6r%2F-Mi-nFShuamhPN9OthIE%2Fimage.png?alt=media\&token=76b530d7-4c3e-487d-a547-74b59b289e6e)

## Tích hợp hệ thống tự động xác nhận thanh toán

{% hint style="success" %}
Mẹo: Sử dụng các tài khoản ngân hàng nhận tiền như Vietinbank, Vietcombank, ACB, TimoPlus để nhận được giao dịch nhanh và ổn định nhất.
{% endhint %}

{% hint style="warning" %}
Casso chỉ hỗ trợ tích hợp ở bản Sapo web, chưa hỗ trợ với Sapo Omni vì Sapo có thu phí API Omni theo tháng. Nếu khách hàng đã mua API Omni từ Sapo và cần hỗ trợ tích hợp, hay vui lòng [liên hệ Casso](https://www.facebook.com/cassovn).
{% endhint %}

{% hint style="danger" %}
Sapo cho phép thiết lập tiền tố và hậu tố cho đơn hàng. Để hỗ trợ xác nhận thanh toán tự động, quý khách vui lòng **không** **thiết lập tiền tố và hậu tố có chứa ký tự số**.
{% endhint %}