5 About Qpay

QPAY-н тухай

QPay төлбөрийн үйлчилгээнд өөрийн үйлчилгээг холбон төлбөр тооцоогоо худалдан QPay QR кодоор авах боломжыг мерчантуудад олгох зорилготой бүтээгдсэн платформ юм. Үндсэн homepage:
https://qpay.mn/

Хөгжүүлэгчдэд зориулсан хуудас:
V1:
https://documenter.getpostman.com/view/2098205/SW7c1Sgg#intro

V2:
https://developer.qpay.mn/

Qpay API endpoint:
V1:

• Production: https://api.qpay.mn/v1
• Test:

V2:

• Production:
• Test: https://merchant-sandbox.qpay.mn/v2

QPAY төлбөрийн үндсэн sequence diagram:

Sequence diagram-н тайлбар:

1. Байгууллага/мерчант нэхэмжлэх үүсгэх хүсэлтээ Qpay API руу явуулна (Invoice create)
2. Qpay хүсэлтийн дагуу QR код болон deeplink агуулсан хариу буцаана.
3. Байгууллага/мерчант үүссэн QR код эсвэл deeplink-г хэрэглэгчид харуулна.
4. Хэрэглэгч QR кодыг шууд банкны аппликэйшнээр уншуулах эсвэл үүсгэсэн deeplink буюу банкнуудаас сонголтоо хийж банкны аппликэйшнээ нээнэ.
5. Банкны аппликэйшнээс QR код эсвэл deeplink-г задлах хүсэлт явуулна.
6. Qpay-с банкны аппликэйшн рүү 1 дээр нэхэмжлэлийн мэдээллийг явуулна.
7. Хэрэглэгч төлбөр хийнэ.
8. Банкны аппликэйшнээс төлбөр төлөгдсөн эсэх мэдээллийг Qpay-рүү буцаана.
9. Qpay-с 1 дээр нэхэмжлэх үүсгэх үед тохируулсан хаягруу төлбөр төлөгдсөн эсэх мэдээллийг явуулна.
10. Байгууллага/мерчант тухайн нэхэмжлэх төлөгдөж дууссан эсэхийг баталгаажуулж шалгана.
11. Төлбөр төлөгдсөн эсэх мэдээллийг хэрэглэгчид харуулна.

Алхам тус бүрийн бодит жишээ:

0. Qpay-тэй гэрээ хийж merchant-н мэдээлэл авах ёстой.

   • V1:

     • merchant_id": MERCHANT_CODE,
     • template_id": INVOICE_TYPE_CODE,
     • merchant_customer_code": MERCHANT_CUST_CODE,_
     • client_id: QPAY_CLIENT
     • client_secret: QPAY_SECRET

   • V2:

     • merchant_code": MERCHANT_CODE,
     • merchant_verification_code": MERCHANT_VER_CODE,
     • merchant_customer_code": MERCHANT_CUST_CODE,
     • username: USERNAME
     • password: PASSWORD

1. Гэрээ хийсний дараа API endpoint руу хандахын тулд
   AUTH enpoint-с Access Token, Refresh token авна.
   Get Auth token
   V1:
   URL=https://api.qpay.mn/v1/auth/token

   Request body:

   {
       "client_id": "QPAY_CLIENT",
       "client_secret": "QPAY_SECRET",
       "grant_type": "client",
       "refresh_token": ""
   }

   V2: https://developer.qpay.mn/auth-token

2. Нэхэмлэх үүсгэх 1 дээр авсан Ассess token ашиглана.
   URL=https://api.qpay.mn/v1/bill/create

   Request Header: Bearer: ACCESS_TOKEN

   Request Body:

   {
     "template_id": "TEST_INVOICE",
     "merchant_id": "TEST_MERCHANT",
     "branch_id": "1",
     "pos_id": "1",
     "receiver": {
       "id": "CUST_001",
       "register_no": "",
       "name": "Central brnach",
       "email": "info@info.mn",
       "phone_number":"99888899",
       "note" : "test note"
     },
     "bill_no": "test_123456",
     "date":"2019-11-22 14:30",
     "description":"invoice description",
     "amount":100,
     "btuk_code":"",
     "vat_flag": "0"
   }