EN
See the demo

NovaPay + Krokul CRM

Yes. Krokul CRM has a native connector to NovaPay internet acquiring. From a deal, Krokul opens a payment session for the client, adds a payment for the amount of the payment plan and gives a link to the payment page, and the signed NovaPay postback turns the expected payment into an actual one.

  • NativeA connector built into Krokul. You connect it in the Marketplace with a key or by signing in to the service, and no code is needed.

What your team gets

A NovaPay session for the deal client

A manager clicks «Payment link» in the «Payments» block. Krokul creates a NovaPay session with the name and phone of the deal contact, the postback address and a link to the deal in metadata, then adds a payment for the amount of the payment plan to the session. The client gets a link to the NovaPay payment page.

The NovaPay postback closes the plan

When the client has paid, NovaPay sends a postback to the Krokul address. Krokul checks the signature with the NovaPay public key, takes the amount from payments[].amount and the deal from metadata, matches them against the plan and records the actual payment. The payment.received event goes to accounting, and full coverage of the invoice triggers invoice.paid.

A hold captured after shipping

A session with the holded status means the money is blocked on the client card. Krokul leaves the payment open. When the goods have shipped, the manager clicks «Capture», and Krokul calls Complete hold. The same place lets you cancel the hold through Void session.

A new link closes the old one

If the deal amount changes, the manager creates a new link. Krokul closes the previous session with the Expire session method, so the client does not pay the old amount.

Reconciliation if a postback is lost

For sessions that stay without a postback for a long time, Krokul requests Get status and records the payment from the actual session state. The manager does not search for the payment in the NovaPay account by hand.

What moves between NovaPay and Krokul

NovaPayDirectionKrokulWhen
Session (Create session): merchant_id, client_phone, name, callback_url, metadataKrokul → NovaPayDeal contact and dealA manager creates a payment link
Payment in the session (Add payment): amount in hryvnias, descriptionKrokul → NovaPayExpected deal paymentRight after the session is created
Payment page linkNovaPay → KrokulLink in the «Payments» blockIn reply to adding the payment
Postback: status, metadata, payments[].amountNovaPay → KrokulActual payment, deal feed, payment.received eventThe client has paid
holded status, Complete hold, Void sessionNovaPay ↔ KrokulExpected payment, «Capture» and «Cancel hold» buttonsFunds are blocked; the manager decides
Expire sessionKrokul → NovaPayPrevious link of the planThe manager creates a new link
Get statusNovaPay → KrokulReconciliation of open linksFor sessions without a postback

How to connect today

Connect (native, no code)

  1. In the NovaPay merchant account, open Settings → My companies → Merchants and keys. Take the Merchant ID and generate the keys.
  2. In Krokul, open «Marketplace» → «NovaPay» and fill in the merchant ID, your private key for signing requests, the NovaPay public key for postbacks and the public Krokul address.
  3. For a first test, enter the test environment https://api-qecom.novapay.ua/v1 in the API base URL field. An empty field means the live environment.
  4. Create a link from a deal and make a test payment. Krokul shows NovaPay refusals as text in the integration log.

Questions and answers

Is the NovaPay integration related to Nova Poshta cash on delivery?

No. The NovaPay integration in Krokul works with internet acquiring, that is, with a session, a link and a postback. Cash on delivery is set in the waybill form of the Nova Poshta integration.

What does Krokul do if a NovaPay postback arrives without a valid signature?

Krokul rejects it and records nothing. Without the NovaPay public key in the settings, Krokul accepts no postbacks at all, so the postback address cannot be used for a fake payment.

Can I issue a NovaPay link in dollars or euros?

No. For NovaPay, Krokul accepts only hryvnias. For another currency, connect a provider that accepts it, and Krokul picks it by the payment currency.

How do I test the NovaPay integration without real money?

Set the NovaPay test environment in the settings and make a payment from a deal. All requests and replies are visible in the integration log.

Limits

NovaPay in Krokul accepts payments in hryvnias. This integration covers internet acquiring. Cash on delivery is set in the waybill form of the Nova Poshta integration.

Missing something?

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.

NovaPay is a trademark of its owner. Krokul is not affiliated with NovaPay.

See the demo