/pos-kiosk/listЗарах боломжтой эвентүүд
Query: eventId (заавал биш), limit (1–20), page (заавал). limit нь 20-оос их байж болохгүй.
portal.mnDEVELOPER DOCSPortal.mn тасалбарын системийг өөрийн киоск болон мобайл аппликейшнд холбох API заавар.
Харилцагчийн киоск дээр Portal.mn тасалбарыг борлуулна.
Эвент, тасалбар, invoice болон төлбөрийн урсгалыг холбох.
Portal.mn баг харилцагчид clientName, secretKey болон checksum үүсгэх нууц SPKEY олгоно. Эдгээр утгыг нууцлан хадгалж, client талын эх код эсвэл олон нийтэд ил API-д бүү байршуул.
Хүсэлт бүрд p-client-checksum болон p-client-service header-ийг илгээнэ. Checksum нь clientName, secretKey, expiresAt утгыг AES-256-CBC ашиглан шифрлэнэ.
expiresAt нь epoch миллисекундээрх тоон утга байна. Одоогийн цаг дээр яг 2 минут нэмнэ. Хугацаа хэтэрсэн checksum эсвэл буруу төрөлтэй утгыг сервер 400 алдаагаар татгалзана.
import * as crypto from 'crypto'
export function encrypt(clientName, secretKey, SPKEY) {
const key = crypto.createHash('sha256').update(SPKEY).digest()
const iv = crypto.randomBytes(16)
const cipher = crypto.createCipheriv('aes-256-cbc', key, iv)
const payload = JSON.stringify({
clientName,
secretKey,
expiresAt: Date.now() + 2 * 60 * 1000,
})
let encrypted = cipher.update(payload, 'utf8', 'hex')
encrypted += cipher.final('hex')
return iv.toString('hex') + ':' + encrypted
}long expiresAt = System.currentTimeMillis() + 2 * 60 * 1000;
String json = String.format(
"{\"clientName\":\"%s\",\"secretKey\":\"%s\",\"expiresAt\":%d}",
clientName, secretKey, expiresAt
);
Cipher cipher = Cipher.getInstance("AES/CBC/PKCS5Padding");
cipher.init(Cipher.ENCRYPT_MODE, key, new IvParameterSpec(ivBytes));
byte[] encrypted = cipher.doFinal(json.getBytes(StandardCharsets.UTF_8));
return bytesToHex(ivBytes) + ":" + bytesToHex(encrypted);p-client-service header-д хүсэлтийн зорилгыг заасан кодыг илгээнэ.
PLSTЗарах боломжтой эвентүүд авахPDSTIЭвентийн дэлгэрэнгүй мэдээлэл авахPLCKTASТасалбар / merch түгжиж invoice үүсгэхPTSCSSТөлбөр амжилттайг баталгаажуулахPULCKTInvoice цуцалж түгжээг суллахPTTCKTInvoice шалгаж тасалбар авахPTLSTТасалбарын жагсаалтPTDSTIТасалбарын дэлгэрэнгүйPMLSTMerch жагсаалтPMDSTIMerch дэлгэрэнгүйPIEBMTИ-баримт авахPFNDRTNТасалбар буцаах (зөвхөн v1)Хөгжүүлэлт, туршилтаа Stage орчинд хийж, production-д гарахдаа үндсэн серверийн хаягийг ашиглана.
https://client-ap.portal.mn/v1https://st-client.portal.mn/v1/pos-kiosk/listQuery: eventId (заавал биш), limit (1–20), page (заавал). limit нь 20-оос их байж болохгүй.
/pos-kiosk/detail/{eventId}Эвентийн тасалбарын template, суудлын тохиргоо зэрэг мэдээллийг буцаана.
v2 эвент харах, detail авах болон invoice үүсгэхэд Portal.mn-ээс “Kiosk v2” эрх нээлгэсэн байх шаардлагатай. Talon-оор зарагддаг эвент киоск борлуулалтад дэмжигдэхгүй. v2 эвентийн буцаалт боломжгүй.
Суудлын зураглал, боломжит суудлын бодит цагийн төлөвийг Portal.mn-ийн Seat Picker WebView харуулна. Апп дотроо суудлын зураглалыг дахин зурах шаардлагагүй.
https://portal.mn/seat-picker/{eventId}https://stage.portal.mn/seat-picker/{eventId}#1E1E1E.Хэрэглэгч суудлаа сонгох бүрд WebView-ийн URL seats query параметрээр шинэчлэгдэнэ. URL өөрчлөлтийг сонсож утгыг таслалаар салган авна; параметр хоосон бол сонголт хийгдээгүй гэж үзнэ.
https://portal.mn/seat-picker/{eventId}?seats=SF2-R1-s9,SF2-R1-s10\n\n// -> ['SF2-R1-s9', 'SF2-R1-s10']FДавхар (Floor)F2 → 2-р давхарVVIP хэсэгV1 → VIP 1T / tШирээ (Table)T4 → 4-р ширээGХаалга (Gate)G1 → 1-р хаалгаZБүс (Zone)Z2 → 2-р бүсSСектор (Sector)SF2 → F2 секторRЭгнээ (Row)R1 → 1-р эгнээsСуудал (Seat)s9 → 9-р суудалСонгосон суудлын код аль template-ийн seatIds-д байгааг олж, ижил templateId-ийн суудлуудыг нэгтгэн invoice хүсэлтэд илгээнэ. seatIds тодорхойгүй бол хоосон seatIds-тэй isSeat: true template ашиглана.
/pos-kiosk/invoiceBody: eventId болон templates[] — templateId дээр seats[] (суудалтай) эсвэл тоо ширхэг (суудалгүй) дамжуулна.
{
"eventId": "65b1234567890abcdef12345",
"templates": [
{ "templateId": "65b1234567890abcdef12346", "seats": ["SF2-R1-s9", "SF2-R1-s10"] },
{ "templateId": "65b1234567890abcdef12347", "seats": 2 }
]
}v1: 10 минутын дотор хүчинтэй. v2: хамгийн ихдээ 15 минут.
Амжилттай бол /to-success/{invoiceId}-г заавал дуудна.
/discard/{invoiceId}-г дуудан тасалбарын түгжээг суллана.
/check-invoice/{invoiceId} хүсэлт төлөгдсөн invoice-ийн QR-уудыг буцаана.
Төлбөр амжилттай болсон ч баталгаажуулалт хийхгүй бол invoice хугацаа дуусахад автоматаар цуцлагдаж, тасалбар түгжээнээс гарна.
/pos-kiosk/ticketspage · limit · eventId?
/pos-kiosk/ticket/{id}id — тасалбарын ID
/pos-kiosk/merchespage · limit · eventId?
/pos-kiosk/merches/{id}id — merch-ийн ID
Тасалбар болон merch жагсаалтад page, limit, eventId query параметр ашиглана. eventId өгөхгүй бол бүх борлуулалтын жагсаалт буцна.
/pos-kiosk/ebarimt/{invoiceId}v2 invoice төлөгдсөн байх ёстой. Receipt-ийн төрлийг хүсэлтэд дамжуулахгүй; Portal.mn-ийн event тохиргоогоор шийдэгдэнэ.
И-баримтын нэг хүсэлт ойролцоогоор 24 секунд хүртэл хүлээж болно. Receipt алдаа давтагдвал Portal.mn-ийн багт хандана уу.
/pos-kiosk/refund/{invoiceId}Зөвхөн v1 event-д дэмжигдэнэ. v2 invoice буцаахад 400 refundNotAvailable алдаа гарна.