API баримт бичиг
Системээ Payment System API-тай холбох
Нэхэмжлэх үүсгэх, төлбөрийн линк хуваалцах, харилцагч удирдах зэргийг программаас хийх боломжтой — эсвэл MCP-ээр AI туслахад даалгаж болно. Хоёр интерфейс ижил валидаци, эрх, мерчант хамрах хүрээг ашиглана.
REST API эсвэл MCP — алийг нь сонгох вэ?
- REST API — систем хоорондын интеграцад: таны backend нэхэмжлэх автоматаар үүсгэж, төлөв шалгаж, каталог удирдана.
- MCP — AI туслах (Claude, Cursor г.м.) ижил үйлдлүүдийг хэрэгсэл болгон харилцан ярианы хэлбэрээр гүйцэтгэнэ.
Хурдан эхлэл
- Профайл хуудсаас API токен үүсгэх
- Доорх үндсэн URL-г хуулах
- Эхний хүсэлтээ илгээх
Жишээ хүсэлт
curl https://admin.onepay.tabsystems.tech/api/v1/invoices \
-H "Authorization: Bearer psk_your_token_here"Баталгаажуулалт
Хүсэлт бүрд API токен агуулсан Authorization толгой шаардлагатай. Токеныг профайл хуудсаас хүчингүй болгож болно.
Токен нь үүсгэсэн хэрэглэгчийн эрхийг өвлөнө. Профайл хуудсаас хүчингүй болгох эсвэл хугацаа тохируулж болох ба хүчингүй болголт REST, MCP хоёуланд шууд үйлчилнэ.
Үндсэн URL: https://admin.onepay.tabsystems.tech/api/v1
Authorization: Bearer psk_your_token_hereАлдаанууд
| 400 | Баталгаажуулалт амжилтгүй: body/query нь схемтэй тохирохгүй байна; `issues`-д Zod-ийн алдаанууд жагсаагдана |
| 401 | API токен байхгүй, хүчингүй, хугацаа дууссан эсвэл цуцлагдсан |
| 403 | Токенд энэ үйлдлийг хийх эрх байхгүй |
| 422 | Домэйн дүрэм зөрчигдсөн (жишээ нь: invalidAmount, noPaymentProvider) |