Online Merchant Guide

Онлайн Мерчант Гарын Авлага

Мерчант: Бонум-ын харилцагч
Мерчант портал: https://merchant.bonum.mn/ — Бонум-ын хэрэглэгчийн систем
Хэрэглэгч: Мерчантаас үйлчилгээ авч буй харилцагч

1. Мерчант бүртгэл

Мерчант нь Мерчант портал дээрх бүртгэлтэй мэйл хаягийг авсан байна. Бонумаас Мерчант порталд Мерчантын бүртгэлийг үүсгэж терминал болон "SecretKey"-ийг үүсгэсэн байна.

https://merchant.bonum.mn/ И-мэйл хэсэгт бүртгэлтэй мэйл хаягаа оруулж OTP хүлээн авч нэвтэрнэ.

Merchant Portal Login
2. Мерчантын боломжууд

Мерчантад дараах боломжууд байгаа:

  • Карт холбох (Tokenization)
  • E Commerce (Картын гүйлгээ)
  • QR Invoice үүсгэх
  • Payment Plan үүсгэж төлбөр авах
3. Payment Plan

Payment Plan нь тогтмол хугацаагаар төлбөр суутгаж авахад зориулсан функц юм.

Жишээ нь: 7 хоног бүр 1 удаа төлбөр авах, Сар бүрийн 1-нд төлбөр авах гэх мэт автоматаар төлбөр авахад ашиглана.

PaymentPlan-ийг Мерчант нь Мерчант портал эрхээр нэвтэрч үүсгэнэ.

Payment Plan
4. Webhook бүртгүүлэх

Мерчант Бонумын ажилтанд өөрийн Webhook URL-ыг өгч бүртгүүлнэ.

Функц бүр дээр төлбөр гарах бүрт Webhook рүү мэдээлэл дамжуулна.

WebHook-рүү очих Message "POST METHOD" очно.

Webhook Registration
5. Карт холбох (Tokenization)

Хэрэглэгчиддээ Subscription/PaymentPlan-ийг хэрэглэх боломжийг өгнө.

Мерчант олон Plan үүсгэж болно. Харин Хэрэглэгч 1 удаа Token үүсгээд Мерчантын PaymentPlan-ууд руу тухайн үүсгэсэн Token-оор Subscription хийх боломжтой. Мөн Token-оор Purchase хийх боломжтой.

6. Card Token үүсгэх

Card Token үүсгэхэд:

  • "Create card token" хүсэлтийг дуудна. Хариу URL ирнэ.
  • URL-ийг browser/webview дээр харуулна.
  • URL нь хэрэглэгчид картын мэдээлэл оруулж баталгаажуулах форм байдаг.
  • Хэрэглэгч картын мэдээллээ оруулаад баталгаажуулсны дараа Token үүсч WebHook-рүү "CARD-TOKEN" гэсэн төрөлтэй Message очно.
  • Мерчант Card token-ийг өөрийн DB дээр харилцагчтайгаа холбож хадгална.

Хадгалсан Token-оор Subscription хийх, Purchase хийх боломжуудыг Мерчант өөрийн системээр дамжуулан хийнэ.

Online Merchant Guide

Merchant: Bonum's client
Merchant Portal: https://merchant.bonum.mn/ — Bonum's client system
Customer: The end user receiving services from the merchant

1. Merchant Account Setup

The merchant receives the email address registered on the Merchant Portal. Bonum creates the merchant's account on the Merchant Portal, generates the terminal, and issues a "SecretKey."

The merchant logs in at https://merchant.bonum.mn/ by entering the registered email address, receiving an OTP, and verifying it.

Merchant Portal Login
2. Merchant Capabilities

Merchants have access to the following features:

  • Card Linking (Tokenization)
  • E-Commerce (Card Payments)
  • QR Invoice Generation
  • Payment Plan creation and recurring payments collection
3. Payment Plan

The Payment Plan function is designed for automated, recurring payments.

For example: deducting payments every week or on the 1st of every month.

Merchants can create Payment Plans by logging into the Merchant Portal.

Payment Plan
4. Webhook Registration

The merchant provides their Webhook URL to Bonum staff for registration.

Each time a payment occurs under any function, a message will be sent to the registered Webhook.

The Webhook receives messages via the POST METHOD.

Webhook Registration
5. Card Linking (Tokenization)

This allows merchants to offer customers the ability to use Subscription/Payment Plan features.

A merchant can create multiple plans, while a customer only needs to create a single Token once. Using that Token, the customer can subscribe to any of the merchant's Payment Plans or make purchases directly.

6. Creating a Card Token

Creating a Card Token:

  • The merchant sends a "Create Card Token" request. A response containing a URL is returned.
  • The URL is displayed in a browser or webview.
  • The URL contains a form where the customer inputs and verifies their card details.
  • Once the customer submits and verifies their information, a Token is generated, and a message with the type "CARD-TOKEN" is sent to the registered Webhook.
  • The merchant then stores the Card Token in their database, linked with the corresponding customer.

Using the stored Token, the merchant can perform Subscription or Purchase transactions through their own system.

Support & Contact

References:
Merchant Portal - https://merchant.bonum.mn/
Bonum Gateway APIs - API Documentation


If you need further assistance, please contact our team:
- Email: info@bonum.mn
- Phone: +976 7200-5000