# Tích hợp MoMo

## Những điều cần lưu ý

1. Cần **kiểm tra kỹ** và **nhập đúng** các thông tin kết nối MoMo ở Hub
2. Sau khi kết nối, vui lòng **không thay đổi thông tin** trong quá trình CNV đồng bộ dữ liệu
3. Tài khoản kết nối phải là Admin của Hub

## Quy trình kết nối và tiến hành kích hoạt sử dụng MoMo ở App user

**Bước 1:** Merchant tiến hành liên lạc với MoMo => MoMo sẽ gửi thông tin tài khoản MoMo Business ở môi trường Test cho Merchant

**Bước 2:** Team AM hướng dẫn hoặc tiến hành kết nối MoMo ở môi trường test cho khách trong mục <https://app.cnvloyalty.com/settings/payment>

**Bước 3:** Tiến hành kiểm tra trên App đã có thể thanh toán đơn hàng bằng MoMo không

Các bước: Tạo đơn -> chọn phương thức thanh toán là MoMo -> Mở app MoMo Test (Link hướng dẫn: <https://developers.momo.vn/v3/vi/docs/payment/onboarding/test-instructions/>) -> Xác nhận thanh toán thành công (GHI LẠI VIDEO ĐỂ GỬI XÁC NHẬN CHO MOMO)

{% hint style="warning" %}
Nế*u không thể mở app MoMo => Báo team MoMo để tiến hành kích hoạt deeplink ở môi trường test => sau đó báo Mobile kiểm tra và test lại*&#x20;
{% endhint %}

**Bước 4:** Gửi video xác nhận cho MoMo

**Bước 5:** MoMo xác nhận và hoàn thành hợp đồng với Merchant

**Bước 6:** Khi xong hợp đồng, báo team MoMo kích hoạt deeplink ở môi trường Production  => báo team Mobile kiểm tra => test hoàn thiện

## Bước 1: Lấy thông tin kết nối ở MoMo

### 1. Merchant chưa có tài khoản MoMo

1. Merchant [đăng ký tài khoản doanh nghiệp](https://business.momo.vn/signup)
2. Điền Thông tin tài khoản và Thông tin doanh nghiệp
3. Hoàn tất đăng ký, email xác thực để kích hoạt tài khoản sẽ được gửi đến email đã đăng ký của Merchant

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2FJNqpy85UnSNKbN6pygsP%2Fimage.png?alt=media\&token=29149edd-d96f-457d-a8d8-57106293d177)

### 2. Merchant đã có tài khoản MoMo

[Đăng nhập MoMo](https://business.momo.vn/login)

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2Fj6Ld1BKuQBvEeAqmusn7%2Fimage.png?alt=media\&token=c7994a61-b2ed-43a1-b92f-bb4037e1c104)

### 3. Xác thực tài khoản doanh nghiệp

#### 1. Thông tin thanh toán

* Vài Cài đặt ➝ Thông tin thanh toán
* Merchant có thể chọn 1 trong 2 hình thức thanh toán
  * Thanh toán qua ví MoMo : nhập thông tin ví MoMo
  * Thanh toán qua tài khoản ngân hàng : nhập thông tin tài khoản

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2FMidBga3p0mRaHVugzWeO%2Fimage.png?alt=media\&token=0a393c41-214d-45ca-a334-4ad9bb0d5ad1)

#### 2. Upload Logo

* Vào Tài khoản của tôi ➝ Thông tin tài khoản ➝ Logo
  * Kích thước hình ảnh : 100x100 pixel

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2FB1BzTpWYuW04Hi0cT4Xc%2Fimage.png?alt=media\&token=b29809a5-068f-456d-9c3f-ab79dd15dd88)

#### 3. Giấy phép kinh doanh

* Vào Tài khoản của tôi ➝ Giấy tờ
  * Giấy tờ pháp lý : các giấy tờ Merchant cung cấp để MoMo xác thực và kiểm tra thông tin
  * Giấy tờ khác : tùy thuộc vào từng Merchant, sau khi MoMo kiểm tra thông tin, Merchant có thể được yêu cầu cung cấp thêm các giấy tờ khác

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2FVJmbrCPwE4y8seCLnTMA%2Fimage.png?alt=media\&token=4ca7b465-5ad1-4d48-91ba-a506ad3c12f3)

#### 4. Hợp đồng điện tử

* Kiểm tra lại thông tin trên Hợp đồng và các điều khoản
* Nhấp dấu stick vào ô "*Tôi đã xem và đồng ý với các điều khoản của Hợp đồng điện tử"*
* Chọn Đồng ý

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2FekEKgmLEbOfZ8egbQYkr%2Fimage.png?alt=media\&token=d6d2f28a-2ecc-40a4-9852-afd1b2578b63)

#### 5. Hoàn tất xác thực tài khoản

* QA và Legal của MoMo sẽ tiến hành kiểm tra thông tin của doanh nghiệp và xác thực doanh nghiệp
* Sau khi doanh nghiệp hoàn tất thực hiện các bước xác thực, MoMo sẽ tiến hành xác thực thông tin của doanh nghiệp và chủ động liên hệ lại với doanh nghiệp. Để được hỗ trợ thêm, vui lòng liên hệ MoMo

### 4. Lấy thông tin kết nối

#### 1. Tích hợp trên môi trường Test

* Vào Dịch vụ bổ sung ➝ Tích hợp thanh toán ➝ Tích hợp website
* Lấy thông tin
  * Partner Code
  * Access Key
  * Secret Key

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2FY0vtv8uZOwsLzkuJMLLV%2Fimage.png?alt=media\&token=2296f142-0737-4cbb-a4b1-433b744aeca1)

{% hint style="success" %}
Chọn icon con mắt (:eye:) để sao chép đầy đủ thông tin Access Key và Secret Key
{% endhint %}

* Vào  Dịch vụ bổ sung ➝ Tích hợp thanh toán ➝ Tích hợp Mobile
* Lấy thông tin Pub Key : Public Key

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2FiJHkKfNCGloymEU2seO7%2Fimage.png?alt=media\&token=8b8b064d-b64e-453b-abc6-e8ede9984e80)

{% hint style="success" %}
Chọn icon con mắt (:eye:) để sao chép đầy đủ thông tin Pub Key
{% endhint %}

#### 2. Tích hợp trên môi trường Production

{% hint style="danger" %}
Đối với Merchant không phải SME, cần hoàn thiện hợp đồng và các thủ tục cần thiết với MoMo trước khi thực hiện tích hợp trên môi trường Production
{% endhint %}

* Chọn PROD ➝ Đồng ý
* Các bước lấy thông tin tương tự môi trường Test

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2FnvEgagwdYFuV5x73L6dn%2Fimage.png?alt=media\&token=60461897-b4b6-4314-93da-72e040060428)

## Bước 2: Vào Cấu hình ➝ Thanh toán

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2FGOViSlsOJFb9rMtD0nxa%2Fimage.png?alt=media\&token=550685af-cfef-43ef-8cb2-4061c95e98e7)

## Bước 3: Thêm MoMo

* Chọn *+ Thêm cổng thanh toán* ➝ chọn :heavy\_plus\_sign:

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2FTVvQ8F7tFYXjgNXnjsDD%2Fimage.png?alt=media\&token=6c7da0e0-86a0-481d-ba1c-acfc4a00dcb8)

## Bước 4: Chọn phương thức thanh toán

1. Chọn Kết nối
2. Chọn phương thức thanh toán ➝ Ví MoMo

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2FKoA5lbGrR5nGXzu85dwF%2Fimage.png?alt=media\&token=a8904b5f-30f5-4f33-9892-e55ae488acc4)

## Bước 5: Nhập thông tin đã lấy ở bước 1

* Tên phương thức: tên phương thức thanh toán
* Partner Code
* Access Key
* Secret Key
* Public Key : Pub Key

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2FwEPBcaFvcu2fs6antTN1%2Fimage.png?alt=media\&token=e7523830-577f-499f-a60c-2546741dd941)

## Bước 6: Chọn Môi trường thử nghiệm

{% hint style="warning" %}
Môi trường thử nghiệm dành cho môi trường Test của MoMo
{% endhint %}

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2F9oJRLe9W7OKSW0YX9nTm%2Fimage.png?alt=media\&token=96a311b4-50ff-405d-b5ac-5e1834ab9326)

## Bước 7: Kích hoạt MoMo

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2FnzQ11ew7AG4e6vZ5Grb1%2Fimage.png?alt=media\&token=23e321ff-182a-4262-9d6d-4344773432d0)
