Урсгалаа сонгох¶
Юу хийх: таны систем хүнээс Gerege App-аар яаж төлбөр авахыг 2 минутад шийдэх. Дөрвөн урсгал (
presentment) бий; бүгд нэг payment intent, нэг webhook, нэг тооцоотой — ялгаа нь хүн төлбөрт яаж хүрэх вэ.
1. Шийдвэрийн мод¶
Таны апп Gerege App ДОТОР нээгдэх үү (launcher-т tile)?
├─ Тийм ─────────────────────────────────────────────▶ mini app · presentment "app"
└─ Үгүй — та худалдагч (kind "merchant"):
Хүн хаана байна?
├─ Таны вэб / апп дотор, checkout дээр ───────────▶ "redirect" (pay_url руу чиглүүлнэ, return_url-аар буцна)
├─ Таны дэлгэцийн өмнө (касс, kiosk, POS) ────────▶ "qr" (сагс бүрт шинэ QR)
└─ Байнгын цэг дээр (sticker, NFC, вендинг) ──────▶ "terminal" (QR/NFC терминалыг нэрлэнэ, дүнг биш)
Нэг платформ дээр олон эзэмшигч (машин бүр өөр эзэнтэй)? ──▶ + дэд худалдагч (sub-merchant)
Бараа өгсний ДАРАА мөнгө авах уу (машин гаргах, захиалга бэлдэх)? ──▶ + capture_method "manual"
2. Харьцуулалт¶
app |
redirect |
qr |
terminal |
|
|---|---|---|---|---|
| Хэн | mini app | вэб дэлгүүр, мобайл апп | касс, kiosk, POS, нэхэмжлэх | вендинг, NFC sticker, байнгын QR |
| Intent үүсгэх | хүний access token (Bearer) |
апп-ын client credential (Basic) |
Basic |
Basic |
| Хүн яаж хүрэх | bridge requestPayment |
pay_url (утсанд апп нээгдэнэ) |
дэлгэц дээрх pay_url-ийн QR |
терминалын url (sticker QR, NFC) |
| Хүн хэзээ тодорхой болох | үүсэхэд | claim хийхэд | claim хийхэд | claim хийхэд |
| Заавал талбар | — | return_url (host нь return_hosts-д) |
— | terminal_id |
user_ref |
апп-д тогтмол pairwise sub |
төлбөр бүрт санамсаргүй | төлбөр бүрт санамсаргүй | төлбөр бүрт санамсаргүй |
| Ердийн capture | automatic | automatic | automatic / manual | manual, capture_within 60–300 с |
| Эхлэх | Mini app | Gerege App-аар төлөх | Quickstart | Терминал |
Gerege App (iOS)-ын апп доторх QR товч ба NFC уншигч TestFlight 121-ээс хойшх build-д; камераар уншуулах (Universal
Link) ба компьютер дээрх /pay хуудас — «удахгүй». Утас хэрэггүйгээр хүний алхмыг Quickstart-ийн §7
шиг тоглуулж туршина.
3. Ердийн хослолууд¶
| Бизнес | Урсгал | Тэмдэглэл |
|---|---|---|
| Онлайн дэлгүүр | redirect |
захиалгын дугаар = Idempotency-Key = reference; буцсан URL-д итгэхгүй — GET-ээр шалга |
| Кафе, дэлгүүрийн касс | qr |
expires_in богино (60–300 с) — дэлгэц дээр үлдсэн QR-ийг өөр хүн уншуулахгүй |
| Вендинг машин | terminal + manual |
гарсан → capture, гараагүй → cancel, хариугүй → автоматаар суллагдана |
| Олон эзэнтэй машины сүлжээ | terminal + дэд худалдагч |
эзэмшигч бүр payout дансаа Gerege App-д өөрөө батална |
| Kiosk hub (олон үйлчилгээ) | qr + дэд худалдагч |
үйлчилгээ үзүүлэгч бүр — дэд худалдагч |
| Нэхэмжлэх, ашиглалтын төлбөр | redirect (SMS/имэйл холбоос) эсвэл qr (цаасан дээр) |
expires_in одоо ≤ 1800 с; урт хугацаатай нэхэмжлэх — «удахгүй» |
| Gerege App доторх үйлчилгээ | app |
manifest, review, launcher |
4. Цааш¶
Ойлголтын тойм — объект бүр хэнийх, юутай холбогдох. Төлбөрийн урсгалууд ба
claim — pay_url, claim-ийн хамгаалалт.