strapi-plugin-vnpay/README.md

A strapi plugin for easy integration of VNPay.

# VNPay Strapi Plugin

Package này giúp tích hợp VNPay với Strapi.

## Mục lục
- [VNPay Strapi Plugin](#vnpay-strapi-plugin)
  - [Mục lục](#mục-lục)
    - [Cài đặt](#cài-đặt)
    - [Cấu hình](#cấu-hình)
    - [Sử dụng](#sử-dụng)
    - [Mở rộng](#mở-rộng)

### Cài đặt
```npm install --save strapi-plugin-vnpay```
Hoặc
```yarn add strapi-plugin-vnpay```

### Cấu hình
Trong admin panel của Strapi, cấu hình như sau:
![Img][https://gitlab.com/vietanh8i1998/strapi-plugin-vnpay/-/blob/main/assets/screenshot_1.png]

* Địa chỉ cổng thanh toán VnPay: Đối với môi trường test, hãy sử dụng ```https: //sandbox.vnpayment.vn/paymentv2/vpcpay.html```
* Mã merchant (Hoặc mã website - vnp_TmnCode): Do VNPay cung cấp
* Phiên bản API mà merchant kết nối: ```2.0.1``` hoặc ```2.1.0``` (Mặc định ```2.1.0```)
* Ngôn ngữ giao diện hiển thị: Ngôn ngữ giao diện màn hình thanh toán của khách hàng (```vi``` - Tiếng Việt), (```en``` - Tiếng Anh)
* Chuỗi bí mật: Do VNPay cung cấp
* Địa chỉ URL chuyển hướng: Sau khi thanh toán, VNPay sẽ chuyển hướng tới URL này và đính kèm thông tin thanh toán.
### Sử dụng
1. Bạn cần tạo nút thanh toán (front-end) và gửi một POST request tới ```api-url.com/vnpay/checkout``` 
2. Parameters: 
  * ```vnp_IpAddr``` - Địa chỉ IP của khách hàng
  * ```vnp_OrderInfo``` - Thông tin đơn hàng (**Lưu ý: Không dấu**) - Ví dụ: THANH TOAN DON HANG ABCD
  * ```vnp_Amount``` - Tổng số tiền thanh toán (**Lưu ý: Định dạng số, không dấu ```,``` hoặc ```,```**)
  * ```vnp_OrderType``` - Mã mặt hàng thanh toán [Xem thêm](https://sandbox.vnpayment.vn/apis/docs/loai-hang-hoa/)
### Mở rộng
WIP