Skip to content

5 About Qpay

Jump to bottom
moogiikat edited this page Feb 15, 2022 · 11 revisions

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:

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. Төлбөр төлөгдсөн эсэх мэдээллийг хэрэглэгчид харуулна.

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

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

  2. Гэрээ хийсний дараа 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

  3. Нэхэмлэх үүсгэх 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"
}
Clone this wiki locally