Skip to main content

QR_PAID

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

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

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

Headers

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

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

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

    {
        "msgType": "QR_PAID", // Мессежийн төрөл (төлөгдсөн)
        "qrcPayload": "", // QR кодын EMV payload
        "paymentCode": "", // Танай системийн захиалгын/гүйлгээний код
        "trxId": "", // Switch-ээс оноосон гүйлгээний UUID
        "paid": {
            "bankName": "", // Төлөгчийн банкны нэр
            "bankCode": "", // Төлөгчийн банкны код (ж: "0005")
            "accountNumber": "", // Төлөгчийн дансны дугаар
            "accountName": "", // Төлөгчийн дансны нэр
            "accountCurrency": "MNT" // Валют
        }
    }

  • Жишээ

    {
        "msgType": "QR_PAID",
        "qrcPayload": "00020101021226400014A0000008430001...",
        "paymentCode": "ORD-10001",
        "trxId": "7d8e0c23-7f3e-4f2e-9f8b-9a5d3b7b6d21",
        "paid": {
            "bankName": "Khaan Bank",
            "bankCode": "0005",
            "accountNumber": "5027445834",
            "accountName": "Customer Name",
            "accountCurrency": "MNT"
        }
    }

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

Switch нь issuer-д баталгаажуулсан дүнг дамжуулна. Доорх optional талбарууд дэмжигдэнэ.

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

    {
        "trxId": "", // Switch гүйлгээний UUID
        "paymentCode": "", // Танай системийн код
        "paid": {
            "bankName": "", // Төлөгчийн банкны нэр
            "bankCode": "", // Төлөгчийн банкны код
            "accountNumber": "", // Төлөгчийн дансны дугаар
            "accountName": "", // Төлөгчийн дансны нэр
            "accountCurrency": "MNT" // Валют
        },
        "success": true
    }

  • Жишээ

    {
        "trxId": "7d8e0c23-7f3e-4f2e-9f8b-9a5d3b7b6d21",
        "paymentCode": "ORD-10001",
        "paid": {
            "bankName": "Khaan Bank",
            "bankCode": "0005",
            "accountNumber": "5027445834",
            "accountName": "Customer Name",
            "accountCurrency": "MNT"
        },
        "success": true
    }

Тайлбар

  • trxId дутсан тохиолдолд Switch нь QR-ийн payload-оос cache-лэсэн trxId-г хайж ашиглана (цаг хугацааны хязгаартай).
  • paid объект заавал байна (Issuer → Switch, Switch → Acquirer шугамд адил хэлбэртэй).

Issuer note: Issuer тал /messages/paid endpoint ашиглан төлөгдсөн мессеж илгээнэ. Хариу нь дээрх бүтэцтэй байна. Хэрэв isFromAcquirer=true байвал Switch давтан дамжуулахгүй зөвхөн баталгаажуулалтын мэдээлэл буцаана.