PowerGridDocumentation
Platform

ADR-010: Open billing API

1 min readdocs/decisions/010-open-billing-api.mdEdit on GitHub

Төлөв: батлагдсан (2026-11-01, захиалагч) · Холбоотой: powergrid.billing/v1 · architecture §Гар утсаар төлөх

This page has not been translated yet — it is shown in Mongolian, the language it is written in.

01Шийдвэр

  • PowerGrid бол биллер. Нэхэмжлэл ба төлбөрийн статусыг нээлттэй billing API-аар гаргана.
  • Банкны апп, төлбөрийн апп, QR үйлчилгээ, e-Mongolia, вэб, CU зэрэг дэлгүүрийн касс — аль ч суваг нэг стандарт API-д холбогдож нэхэмжлэлийг харуулж, төлбөр авна. Иргэн дуртай аппаараа төлнө.
  • PowerGrid App-ыг төлбөрийн суваг болгон онцлохгүй. App нь хэрэглээ, нэхэмжлэлийн задаргаа, «Download / Share My Data»-д зориулагдана; төлбөр түүгээр дамжих албагүй.
  • Аль ч сувагт зөвхөн дансны дугаар, дүн, масктай нэр очно. Хэрэглээний муруй, хаяг, тоолуурын өгөгдөл хэзээ ч очихгүй.
  • Суваг бүрт ижил дүрэм: callback-д дангаар итгэхгүй (статус асууна), idempotency key-ээр давхар бичилт 0, өдөр бүр ledger ↔ settlement ↔ billing тулгалт.

02Үр дагавар

  • Вэб, дизайн, мэдээллийн материалд «нэг биллер, олон суваг», «PowerGrid App-аар төлөх» гэх мэт App төвтэй үг хэрэглэхгүй; «Нээлттэй billing API, дуртай аппаараа төлнө» гэж бичнэ.
  • payment_provider адаптер нь суваг тус бүрийн онцлогийг (invoice/QR, статус, callback, буцаалт, settlement) хариуцна; шинэ апп нэмэхэд API гэрээ өөрчлөгдөхгүй.
  • Нээлттэй API-ийн нэвтрэлт, rate limit, onboarding (sandbox → production) журмыг тусад нь баримтжуулна.
Was this page helpful?Your answer helps improve the docs.