Yes. Krokul CRM connects to monobank internet acquiring (Plata by mono) with no code. A manager creates a payment link from a deal, the client pays on the payment page, and the monobank webhook turns the expected payment into an actual one and recalculates the paid amount on the deal.
A manager clicks «Payment link» on the deal. Krokul creates an invoice in monobank with the invoice/create method for the expected payment amount and shows the pageUrl, which can go to the client in a messenger or an email. If the deal had no plan, Krokul creates one with a due date equal to the link validity.
When the client has paid, monobank sends a webhook with the success status. Krokul checks the X-Sign signature with the merchant public key, matches the amount and currency against the plan and records the actual payment with the date from the webhook. The payment.received event goes on to accounting or a team chat, and when the deal invoice is fully paid, invoice.paid fires once.
For a prepayment on an order, the money can be only blocked. A webhook with the hold status leaves the payment open. When the goods are ready, the manager clicks «Capture», and Krokul calls invoice/finalize. After the success webhook, the hold becomes an actual payment.
If the client cancels, the manager refunds the payment with a button on the deal. Krokul calls invoice/cancel, and the reversed webhook records the refund in the feed and reduces the paid amount on the deal. The accountant does not have to look for the payment in the monobank account.
When a link expires or the amount changes, the manager creates a new one. Krokul invalidates the previous invoice with the invoice/remove method. For links that expired without a webhook, Krokul checks invoice/status and marks them in the payment plan.
| monobank | Direction | Krokul | When |
|---|---|---|---|
| Invoice (invoice/create): amount in kopecks, currency, webHookUrl | Krokul → monobank | Expected deal payment | A manager clicks «Payment link» |
| invoiceId and pageUrl | monobank → Krokul | Link in the «Payments» block | In reply to the invoice creation |
| success webhook | monobank → Krokul | Actual payment, deal feed, payment.received event | The client has paid |
| hold webhook and invoice/finalize | monobank ↔ Krokul | Expected payment, «Capture» button | Funds are blocked; capture when the manager decides |
| invoice/cancel and the reversed webhook | monobank ↔ Krokul | Refund on the deal, entry in the feed | The manager refunds the payment |
| invoice/remove | Krokul → monobank | Previous link of the expected payment | The manager creates a new link |
| invoice/status | monobank → Krokul | Expired link mark | After the link validity ends |
Krokul records nothing, answers with an error and writes the event to the integration log. Krokul also rejects a webhook with no signature or with a signature that does not match the public key.
Krokul passes hryvnias, dollars, euros, zlotys and pounds to monobank. The currency comes from the expected payment or from the deal.
Hold means the funds are blocked on the client card and still wait to be captured. Krokul shows them as an expected payment until the manager captures the hold and monobank sends success.
Yes. The refund button on the deal cancels the payment in monobank, and the reversed webhook reduces the paid amount on the deal and leaves an entry in the feed.
This page covers monobank acquiring, that is, payment invoices and the payments made on them. monobank sends no webhook for an expired invoice, so Krokul checks the state of such a link with a status request.
Tell us which service you use and what should move between it and Krokul. We reply with the way to do it and when it will be ready.
Request received. We reply to your email.
monobank is a trademark of its owner. Krokul is not affiliated with monobank.