Төлбөрийн төрлүүд
gov-pay-ээр төлөх боломжтой төлбөрийн төрлүүд — төрөл бүрийг аль шүүлтүүрээр хайж, хэрхэн төлөх.
gov-pay нэг API-аар төрийн үйлчилгээний олон төрлийн төлбөрийг дэмждэг. Бүх төрөлд урсгал ижил: нэхэмжлэл хайх → POST /payments → QR/deeplink → webhook баталгаажуулалт. Ялгаа нь зөвхөн аль шүүлтүүрээр хайх:
| Төрөл | Хайх шүүлтүүр | Жишээ query |
|---|---|---|
| Аж ахуйн нэгж, хувь хүний бүх татвар | ttd (эсвэл taxRef) | GET /invoices?ttd=1234567 |
| Машины торгууль | vehicle | GET /invoices?vehicle=1234УБА |
| Авто замын төлбөр | vehicle | GET /invoices?vehicle=1234УБА |
| Үл хөдлөхийн төлбөр | ttd | GET /invoices?ttd=1234567 |
| Газрын төлбөр | ttd | GET /invoices?ttd=1234567 |
| Тэмдэгтийн хураамж | ttd (эсвэл ref/{refNum}) | GET /invoices?ttd=1234567 |
Бүх төрөл ижил InvoiceDto бүтэцтэй буцна — ангиллын тусгай талбар байхгүй. Нэхэмжлэлийн агуулгыг description, хүлээн авагчийг payee талбараас харна. Шүүлтүүрийн дүрмийг (яг нэгийг өгөх) Нэхэмжлэл хуудаснаас үзнэ үү.
Хайлтын гурван хэлбэр
ТТД (регистр)-ээр
Байгууллага, иргэний бүх төлөгдөөгүй нэхэмжлэл нэг дор:
curl "https://sandbox-tts.qpay.mn/api/v1/invoices?ttd=1234567" \
-H "X-API-Key: $GOVPAY_API_KEY"Улсын дугаараар
Тээврийн хэрэгсэлтэй холбоотой бүх нэхэмжлэл:
curl "https://sandbox-tts.qpay.mn/api/v1/invoices?vehicle=1234УБА" \
-H "X-API-Key: $GOVPAY_API_KEY"Нэхэмжлэхийн дугаараар
Тодорхой нэг нэхэмжлэл мэдэгдэж байгаа үед — татварын нэхэмжлэхийн дугаараар (taxRef) эсвэл лавлагааны дугаараар (ref/{refNum}):
curl "https://sandbox-tts.qpay.mn/api/v1/invoices?taxRef=210000123456" \
-H "X-API-Key: $GOVPAY_API_KEY"
curl "https://sandbox-tts.qpay.mn/api/v1/invoices/ref/2100000123456" \
-H "X-API-Key: $GOVPAY_API_KEY"Төрөл бүрийн тодорхойлолт
Аж ахуйн нэгж, хувь хүний бүх татвар
Байгууллага болон иргэний бүх төрлийн татварын нэхэмжлэл. ТТД-ээр хайна; тодорхой нэг татварын нэхэмжлэх мэдэгдэж байвал taxRef-ээр шууд.
Машины торгууль
Тээврийн хэрэгслийн торгууль. Улсын дугаараар хайхад тухайн машинтай холбоотой төлөгдөөгүй нэхэмжлэлүүд ирнэ.
Авто замын төлбөр
Зам ашигласны төлбөр. Мөн улсын дугаараар — торгуультай ижил query, хариун дахь description-оор ялгагдана (ж: «Зам ашигласны төлбөр»).
Үл хөдлөхийн төлбөр
Үл хөдлөх хөрөнгөтэй холбоотой төлбөрүүд. Эзэмшигчийн ТТД-ээр хайхад бусад татварын хамт ирнэ.
Газрын төлбөр
Газрын төлбөр, түрээс. Эзэмшигчийн ТТД-ээр хайгдана.
Тэмдэгтийн хураамж
Улсын тэмдэгтийн хураамж. ТТД-ээр, эсвэл нэхэмжлэхийн дугаар мэдэгдэж байвал ref/{refNum}-ээр шууд лавлана.
Дараагийн алхам
Нэхэмжлэлээ олсны дараа төрөл харгалзахгүй ижил байдлаар төлнө:
- Хариун дахь
id(UUID)-г аваадPOST /paymentsдуудна — QR + deeplink ирнэ. - Webhook-оор
payment.confirmedмэдэгдэл хүлээн авна. - Бүрэн урсгалыг End-to-end интеграц хуудаснаас үзнэ үү.