Payment methods
A payment method is the channel your customers use to pay. Byl currently supports QPay, Golomt Bank (including SocialPay), and Pocket, and you choose which channels to enable on each project.
All enabled payment methods are automatically offered to customers on invoice and checkout pages — no code changes required.
Configure them in the dashboard under your project's Payment methods (Төлбөрийн хэлбэр) menu.
WARNING
An API request that creates a payment with an inactive payment method returns an inactive_payment_method_type error. See the API overview page for error details.
QPay
With QPay, customers pay by scanning a QR code from any bank's app.
You don't need to create a QPay merchant account manually — once business verification succeeds, it is created automatically from your verified information. After it's created, your merchant number appears on the Payment methods page and the status switches to "Active".
If merchant creation fails, retry from the business verification page.
Golomt Bank (SocialPay)
A Golomt Bank merchant account lets you accept card payments and SocialPay. You'll need merchant credentials issued by Golomt Bank:
- Obtain an e-commerce merchant account from Golomt Bank.
- On the Payment methods page, click Connect (Холбох) in the Golomt section.
- Enter the following:
- Environment —
production(live) ordevelopment(testing). - Access token — the token provided by Golomt Bank.
- Hash key — the key provided by Golomt Bank.
- Environment —
- On save, the connection is verified and, if successful, becomes "Active".
Pocket
Accept payments through the Pocket app. You'll need merchant credentials from Pocket:
- Obtain a merchant account from Pocket.
- On the Payment methods page, click Connect (Холбох) in the Pocket section.
- Enter your Client ID and Client secret.
- On save, the connection is verified and branch and terminal setup happens automatically.
Minimum amount
Payments made through Pocket must be greater than 500₮. The Pocket option is unavailable for smaller amounts (invalid_payment_amount_for_pocket_driver error).
Editing and disconnecting
- To update connection credentials, re-enter them via the Edit settings (Тохиргоог засах) button. If you leave a secret field (access token, hash key, client secret) empty, the previous value is kept.
- If invalid credentials are detected, the payment method is automatically deactivated and your team members are notified by email.
- You can remove a payment method with the Disconnect (Салгах) button — but if payments have been made through it, it can't be deleted, to preserve the payment history.
Next steps
- Bank accounts — set up the account that receives your revenue
- Test and Live — requirements for accepting real payments
- Verified business — prerequisite for a QPay merchant account