Эхлүүлэх заавар
Энэ заавар таныг бүртгэлээс эхлээд эхний төлбөрөө хүлээн авах хүртэл алхам алхмаар хөтөлнө. Бүх алхмыг Test горимд, ямар ч төлбөргүйгээр туршиж болно.
1. Бүртгүүлж, төсөл үүсгэх
- byl.mn/dashboard хаягаар бүртгүүлнэ.
- Багаа үүсгэнэ — Byl дээрх бүх зүйл (төсөл, токен, баталгаажуулалт) багт харьяалагдана. Хамтран ажиллагсдаа дараа нь багтаа урьж болно.
- Төслөө үүсгэнэ — төсөл нь таны нэг бизнес, вебсайт эсвэл аппликейшн юм.
Шинэ төсөл Test горимд үүснэ: бүх зүйл бодит горимтой ижил ажиллах бөгөөд гүйлгээ бүр 50 төгрөгөөр хязгаарлагдана. Дэлгэрэнгүйг Test ба Live хуудаснаас уншина уу.
2. Эхний нэхэмжлэхээ үүсгэх
Хамгийн хурдан туршилт — удирдлагын булангийн Нэхэмжлэх цэсээр орж гараар нэхэмжлэх үүсгээд, гарч ирэх линкээр орж 50 төгрөгийн туршилтын төлбөр төлж үзнэ.
API-аар туршихыг хүсвэл:
- Төслийнхөө Тохиргоо → API токэн хуудаснаас токен үүсгэнэ.
- Төслийн ID-гаа Тохиргоо цэснээс хуулна.
- Дараах хүсэлтийг ажиллуулна:
BYL_PROJECT_ID="таны төслийн ID"
BYL_TOKEN="таны API token"
curl -X POST https://byl.mn/api/v1/projects/$BYL_PROJECT_ID/invoices \
-H "Authorization: Bearer $BYL_TOKEN" \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{ "amount": 1000, "description": "Миний эхний нэхэмжлэх" }'Хариунд ирэх url руу орж төлбөрийн урсгалыг туршина. API-ийн бүрэн боломжийг API тойм хуудаснаас үзнэ үү. Laravel хэрэглэдэг бол Laravel SDK-г шууд суулгаж болно.
3. Төлбөр төлөгдсөнийг системдээ мэдэх
Төлбөр төлөгдмөгц Byl таны сервер рүү webhook илгээдэг — invoice.paid, checkout.completed зэрэг event-үүдийг хүлээн авч захиалгаа автоматаар баталгаажуулна. Төслийнхөө Webhook цэсээс endpoint-оо бүртгэнэ.
Мөн Telegram, Discord руу хүнд зориулсан мэдэгдэл тохируулж болно.
4. Live горимд шилжих
Бодит төлбөр хүлээн авахад бэлэн болмогц дараах гурван нөхцөлийг хангана:
- Бизнесээ баталгаажуулна — баталгаажуулалт амжилттай болмогц QPay мерчант эрх, үндсэн банкны данс автоматаар үүснэ.
- Багц идэвхжүүлнэ — өөрт тохирох багцаа сонгоно.
- Үндсэн данстай эсэхээ шалгана — орлого орох данс тодорхой байх ёстой.
Дараа нь төслийн Тохиргоо хэсгээс Live горимд шилжинэ. Test горимд бичсэн код Live горимд өөрчлөлтгүй ажиллана — зөвхөн Live төслийн токен, ID-гаар солино.
Дараагийн алхам
- Бүтээгдэхүүн ба үнэ — бүтээгдэхүүнээ бүртгэж checkout ашиглах
- Checkout — бүтээгдэхүүн, хөнгөлөлт бүхий худалдан авалт
- Subscriptions — сар/жилийн давтагдах төлбөр