Sử Dụng Khuyến Mãi

Người dùng cuối có thể sử dụng khuyến mãi bằng các hình thức thanh toán sau:

• Thanh toán bằng QR Cá Nhân
• Thanh toán bằng Quét Mã QR Động

Bên dưới là hướng dẫn về mỗi hình thức thanh toán có sử dụng khuyến mãi.

Luồng Xử Lý

Thanh toán bằng QR Cá Nhân

Thanh toán bằng Quét Mã QR Động

Đối với hình thức thanh toán Quét Mã QR Động, Đối tác sẽ cung cấp cho MoMo một API để kiểm tra việc áp dụng khuyến mãi.

HTTP Request

GET <your endpoint>

Property	Type	Description
partnerCode	string	Định danh của đối tác trên MoMo
campaignId	string	Mã chương trình định danh bởi MoMo
saleTranId	string	Mã đơn hàng được tạo từ hệ thống đối tác và gửi sang MoMo
voucherCode	string	Mã voucher

HTTP Response

HTTP Status Code: 200

Property	Type	Required	Description
isValid	Boolean		Xác nhận đơn hàng có thoả điều kiện để áp dụng mã voucher
usedBillAmount	Integer		Tổng giá trị đơn hàng trước khuyến mãi
usedDiscountAmount	Integer		Số tiền giảm giá từ voucher
finalBillAmount	Integer		Giá trị đơn hàng còn lại sau khi giảm giá từ voucher
message	String		Mô tả kết quả từ đối tác
errorCode	Integer		Mã lỗi từ đối tác

Thông báo kết quả sử dụng voucher

Đối tác sử dụng API này để gửi thông báo đến MoMo kết quả sử dụng voucher của người dùng.

HTTP Request

POST /v1/merchants/{partnerId}/campaigns/{momoCampaignId}/vouchers/redeem-status

Variable	Type	Description
partnerId	String	Định danh của đối tác trên MoMo
momoCampaignId	String	Mã chương trình định danh bởi MoMo

Thông tin tham số

Property	Type	Required	Description
voucherCode	String		Mã voucher
userPhoneNumber	String		Số điện thoại người dùng sử dụng voucher
momoTransactionId	String		Mã giao dịch của MoMo
partnerTransactionId	String		Mã giao dịch của đối tác
redeemStatus	Enum		Kết quả sử dụng voucher: - SUCCESS - FAIL
saleInfo	Object		Thông tin đơn hàng

Chi tiết nội dung của saleInfo

Property	Type	Required	Description
posId	string		Mã định danh máy POS từ đối tác
posName	string		Tên máy POS
tranDate	long		Thời gian phát sinh giao dịch sử dụng voucher
originalAmount	double		Tổng giá trị đơn hàng trước khuyến mãi của khách hàng
serviceCharge	double		Phần trăm phí dịch vụ (nếu có), giá trị phải nhỏ hơn hoặc bằng 1. Nếu không có phí dịch vụ, mặc định là 0.
serviceChargeAmount	double		Phí dịch vụ
shipFeeAmount	double		Phí giao hàng
vatAmount	double		Thuế VAT của đơn hàng
billAmount	double		Tổng giá trị đơn hàng sau phí dịch vụ, phí giao hàng và thuế VAT. billAmount = originalAmount + serviceChargeAmount + shipFeeAmount + vatAmount
discountAmount	double		Tổng số tiền giảm giá từ voucher
totalAmount	double		Giá trị đơn hàng sau khi giảm giá từ voucher. totalAmount = billAmount - discountAmount
paymentMethod	String		Hình thức thanh toán đơn hàng, bao gồm những phương thức sau: - MOMOSCANNER: Thanh toán bằng QR cá nhân - MOMOQR: Thanh toán bằng Quét mã QR động - CASH: Tiền mặt - CREDIT_CARD: Thẻ tín dụng - VIETQR: Chuyển khoản qua Vietqr

HTTP Response

Property	Type	Description
status	string	See convention for common status code
message	string	The description of the above status code
formErrors	object	Described below. This property is set on status = FAIL and http status code is 400

Mẫu Request

{
   "voucherCode": "E61HE61J",
   "userPhoneNumber": "0915013325",
   "momoTransactionId": "48479590245",
   "partnerTransactionId": "KBJ6G2N4J1R2ENY7IVG7BOT0",
   "redeemStatus": "SUCCESS",
   "saleInfo": {
     "posId": 17130,
     "posName": "iPOS.vn - Văn Phòng",
     "tranId": "KBJ6G2N4J1R2ENY7IVG7BOT0",
     "tranDate": 1702961170,
     "originalAmount": 123000,
     "serviceCharge": 0.08,
     "serviceChargeAmount": 9840,
     "shipFeeAmount": 3000,
     "vatAmount": 5000,
     "billAmount": 140840,
     "discountAmount": 20000,
     "totalAmount": 103000,
     "paymentMethod": "MOMOQR"
   }
}