English

Монгол

English

Монгол

Quickstart ​

This guide walks you step by step from signing up to receiving your first payment. Every step can be tried in Test mode, completely free of charge.

1. Sign up and create a project ​

  1. Sign up at byl.mn/dashboard.
  2. Create your team — everything on Byl (projects, tokens, verification) belongs to a team. You can invite your teammates later.
  3. Create your project — a project represents a single business, website, or application.

New projects start in Test mode: everything works exactly like the real thing, but every transaction is capped at 50₮. See Test and Live for details.

2. Create your first invoice ​

The fastest way to try it out — open the Invoices section of the dashboard, create an invoice manually, then follow the generated link and make a 50₮ test payment.

To try it via the API:

  1. Create a token on your project's Settings → API tokens page.
  2. Copy your project ID from the Settings page.
  3. Run the following request:
shell
BYL_PROJECT_ID="your project ID"
BYL_TOKEN="your 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": "My first invoice" }'

Open the url returned in the response to try the payment flow. See the API Overview for everything the API can do. If you use Laravel, you can install the Laravel SDK right away.

3. Let your system know a payment was made ​

As soon as a payment is made, Byl sends a webhook to your server — receive events such as invoice.paid and checkout.completed to confirm orders automatically. Register your endpoint on your project's Webhooks page.

You can also set up human-facing notifications for Telegram and Discord.

4. Switch to Live mode ​

Once you are ready to accept real payments, meet these three requirements:

  1. Verify your business — once verification succeeds, a QPay merchant account and a primary bank account are created automatically.
  2. Activate a plan — choose the plan that fits you.
  3. Make sure you have a primary bank account — the account where your revenue lands must be set.

Then switch to Live mode from your project's Settings. Code written in Test mode works unchanged in Live mode — just swap in your Live project's token and ID.

Next steps ​