Skip to main content

QR_INQUIRY

Энэ хуудас нь хоёр үүргийг хамарна:

  • Төлбөр хүлээн авагч (Acquirer): Switch-ээс ирсэн лавлагааг (inquiry) хүлээн авч, нэхэмжлэлийн мэдээллээр хариулах
  • Төлбөр төлөгч (Issuer): Switch рүү лавлагаа илгээх — доор "Issuer note" хэсэгт товч заавар хавсаргав

POST https://{your-server-url}

Headers

  • Content-Type: application/json
  • X-Api-Key: CLIENT_KEY

Хүлээж авах мессеж (Switch → Төлбөр хүлээн авагч)​

  • Мессежний бүтэц

    {
        "msgType": "QR_INQUIRY", // Мессежийн төрөл (лавлагаа)
        "qrcPayload": "", // QR кодын EMV payload
        "paymentCode": "", // Танай системийн захиалгын/гүйлгээний код
        "trxId": "" // Switch-ээс олгосон гүйлгээний UUID
    }

  • Жишээ

    {
        "msgType": "QR_INQUIRY",
        "qrcPayload": "00020101021226400014A0000008430001...",
        "paymentCode": "ORD-10001",
        "trxId": "7d8e0c23-7f3e-4f2e-9f8b-9a5d3b7b6d21"
    }

Хариу өгөх мессеж (Төлбөр хүлээн авагч → Switch)​

Switch нь дараах талбаруудыг ашиглан хэвжүүлж (normalize) issuer талд дамжуулна. Optional талбаруудыг дэмждэг тул боломжтой бол бүгдийг өгнө үү.

  • Мессежний бүтэц

    {
        "beneficiaryBankAccounts": [
            // Төлбөр хүлээн авах данснуудын жагсаалт (нэг байсан ч массив)
            {
                "bankName": "", // Банкны нэр
                "bankCode": "", // Банкны код (ж: "0005")
                "accountNumber": "", // Дансны дугаар
                "accountName": "", // Дансны нэр
                "accountCurrency": "MNT", // Валют (default: MNT)
                "isDefault": true // Анхдагч эсэх
            }
        ],
        "customerName": "", // Худалдан авагч/мерчантын нэр
        "customerCode": "", // Худалдан авагч/мерчантын код
        "transactionType": "PURCHASE", // Гүйлгээний төрөл (optional)
        "mccCode": "", // MCC код (optional)
        "amount": 15000, // Дүн
        "currency": "MNT", // Валют (optional, default: MNT)
        "description": "...", // Гүйлгээний утга
        "invoiceCode": "INV20250919", // Нэхэмжлэхийн дугаар (optional)
        "paymentCode": "ORD-10001", // Эх хүсэлтийн кодтой тааруулна (optional)
        "isAllowCard": false, // Картын гүйлгээ зөвшөөрөх эсэх (optional, default: false)
        "charge": 75.0 // Шимтгэл (optional, тоо)
    }

  • Жишээ

    {
        "beneficiaryBankAccounts": [
            {
                "bankName": "Hi Payment Solutions",
                "bankCode": "0051",
                "accountNumber": "6128328515",
                "accountName": "MERCHANT LLC",
                "accountCurrency": "MNT",
                "isDefault": true
            }
        ],
        "customerName": "MERCHANT LLC",
        "customerCode": "MRC-1001",
        "transactionType": "PURCHASE",
        "mccCode": "5311",
        "amount": 15000,
        "currency": "MNT",
        "description": "POS Order #10001",
        "invoiceCode": "INV20250919-0001",
        "paymentCode": "ORD-10001",
        "isAllowCard": false,
        "charge": 75.0
    }

Тайлбар

  • beneficiaryBankAccounts бол массив — ганц данс байсан ч массив хэлбэрээр өгнө үү.
  • transactionType нь Switch-д enum байдлаар хэвжүүлэгдэнэ. Тодорхой бус утга илгээвэл үл тооцно.
  • isAllowCard дутвал false гэж тооцогдоно.
  • charge бол нэмэлт шимтгэл (тоо төрөл). Илгээгүй тохиолдолд үл тооцно.

Issuer note: Issuer тал лавлагаа явуулахдаа Switch /messages/inquiry endpoint-ийг ашиглана (qrcPayload, paymentCode, trxId–г Switch онооно). Хүлээн авах хариу нь дээрх талбаруудтай нийцсэн байна.