↑↓ selectEnter openEsc close

    1. Elbuz
    2. Sales and documents
    3. Working with documents
    4. Money and accounting

    How to accept NovaPay payments in Elbuz: links, hold, refunds

    10 min readUpdated

    Elbuz creates NovaPay for Business payment links for invoices and orders. Charge the money at once, or hold it and capture it after picking; refunds are made from the document card.

    When you need this:

    • Customers pay by card via a link — the document gets the payment, cash receipt and fiscal receipt.
    • An item may be out of stock — with a hold, you capture only what was picked.
    • Order canceled before shipping — “Release hold” unblocks the money.
    • An item was returned — “Refund” from the document, no NovaPay account needed.

    Where to start: enter your NovaPay Merchant ID and key, then click “Payment link” in the invoice.

    What NovaPay can do in Elbuz

    • Connect in two minutes — Merchant ID and private key from the NovaPay account, plus test mode for checks.
    • Links from the document card — for the unpaid amount of an invoice or customer order, by email or in a messenger.
    • Payment recorded automatically — status, cash receipt and PRRO fiscal receipt with the “NovaPay” payment form.
    • Hold — the customer's money is blocked; after picking, you capture all or part of it, or release the hold.
    • Refunds — full or partial, with a cash payment in the document.

    How to connect NovaPay

    Elbuz works with your NovaPay internet acquiring contract: the money goes straight to your account. To connect, you need two values from the NovaPay for Business account, Acquiring section: the Merchant ID and the merchant's RSA private key.

    Where: System settings → “Other settings” → “External services and integrations” → “Payment” group → NovaPay row.

    1. Open the NovaPay row with the pencil icon. The “Connecting NovaPay” form opens.
    2. In the “Merchant ID” field, enter the merchant number from the NovaPay account.
    3. In the “Merchant private key (PEM)” field, paste the whole key — from -----BEGIN PRIVATE KEY----- to -----END PRIVATE KEY-----. If the key was pasted as a single line without line breaks, that works too.
    4. Turn on “Active”. The form saves itself; there's no “Save” button.
    The Connecting NovaPay form with switches, the Merchant ID and key fields and the payment notification URL
    1Where to get the Merchant ID and key
    2Test mode
    3Hold: capture after confirmation
    4Merchant ID
    5Key field
    6Payment notification URL
    1. The hint at the top — where to get the Merchant ID and the RSA private key: in the NovaPay account.
    2. Test mode — the NovaPay test environment, no money is charged.
    3. Hold — the money is blocked on the customer’s card, and you capture it.
    4. Merchant ID — the merchant number from the NovaPay account.
    5. Key field — the key is saved and not shown in the window.
    6. Payment notification URL — you don’t need to enter it in the NovaPay account.

    Elbuz signs every request to NovaPay with the key. After saving, the field shows only “Key saved. To replace it, paste a new one”, and an empty field doesn't erase the old key.

    A key that can't be read isn't saved: the form shows “The key could not be read: paste the whole merchant private key…” and keeps the previous one. If the saved key becomes invalid or keys are missing, the form shows a red banner. In “Payment link”, NovaPay then appears inactive, marked “keys not set up”.

    You don't need to enter the NovaPay public key or a payment notification URL: Elbuz sends the URL with every link.

    Test mode

    “Test mode” switches the service to the NovaPay test environment; no money is charged. Enter Merchant ID 2 and the test key from the NovaPay documentation (Authentication section), where you'll also find test cards.

    Go through the whole flow on a test order. Then turn off “Test mode” and enter your live Merchant ID and key.

    Hold switch

    “Hold: capture after confirmation” is off by default: the payment is charged right away and recorded in the document. When it's on, the money is blocked on the card, and you capture it with a button in the document (how it works).

    The switch applies to links created after you change it.

    How to create a NovaPay link

    The link is created the same way as for other services: invoice or customer order card → “Payment link” → choose NovaPay in the “Payment service” field → “Create link”. Then “Send by email” or “Copy” (more about links and the email).

    NovaPay has two conditions other services don't:

    • Hryvnias only. A document in another currency won't get a link: “NovaPay: currency … is not supported (UAH)”.
    • The customer's phone is required — NovaPay demands it. Elbuz goes through the document phone, the payer's phone and the contact's phones and takes the first Ukrainian number, formatting it as +380XXXXXXXXX. A foreign number in the document doesn't get in the way if the contact has a Ukrainian one.

    The link is for the document's unpaid amount; on the NovaPay page, the customer sees a single line “<document type> No. …” for the full amount. The service status in the document is “Awaiting payment”, and the card shows the “Payment in NovaPay” block with the “Pending” status.

    The block works with the document's latest link. Before creating a new link, Elbuz checks the previous one:

    • not paid — Elbuz cancels it in NovaPay, and the old link stops working for the customer;
    • on hold — no new link is created until the hold is captured or released (message);
    • paid — stays as is, and the new link is for the remaining amount. You can no longer refund the previous payment from the block, only in the NovaPay account;
    • NovaPay didn't respond — no new link is created either, so the customer doesn't pay twice. Try again.

    What the document gets after payment

    NovaPay notifies Elbuz about the payment. Elbuz doesn't trust the notification itself: it takes only the payment number from it and requests the status from NovaPay with your key. So a payment can't be faked, and a repeated notification doesn't double the amount.

    Without a hold, after payment the document has:

    • the “Paid” payment status, or “Prepayment” if not everything was paid;
    • the “Bank card” payment type, and in the “Payment in NovaPay” block — the “Paid” status and the NovaPay transaction number;
    • a posted “Cash receipt” for the amount received, with the transaction number in the description;
    • a fiscal receipt, if “Receipt on payment by link” is on for the PRRO cash register. The payment form on the receipt is “NovaPay”, not “Online acquiring” (receipt on payment by link).

    With a hold, after payment the document gets only the “Hold” status. The payment amount, cash receipt and fiscal receipt appear after “Capture hold”, because until then the money still belongs to the customer.

    NovaPay payment path: the left branch is without a hold, the right one with a hold; a refund is possible only after capture
    customer paid, hold offcustomer paid, hold on“Capture hold” for all or partof the amount“Release hold” or 29 dayswithout capture“Refund” for part“Refund” for the full amountrest refundedPendinglink sentPaidcash receipt and fiscal receipt in thedocumentHoldmoney blocked, document unpaidCanceledfunds unblockedPartially refundedcash paymentRefunded
    • Start
    • State
    • End

    How to capture or release a hold

    A hold is money blocked on the customer's card that only the seller can capture. This way you don't charge for an item that may turn out to be missing and then process a refund.

    Where: document card → “Payment in NovaPay” block. The block appears once a NovaPay link has been created for the document.

    The Payment in NovaPay block in a customer order with the Hold status and action buttons
    1Hold
    2Amount
    3Capture hold
    4Release hold
    5Refresh status
    1. The “Hold” badge — the money is blocked on the customer’s card.
    2. Amount — the payment amount.
    3. Capture hold — capture the whole amount or part of it.
    4. Release hold — unblock the money for the customer.
    5. Refresh status — request the status from NovaPay.
    • “Capture hold” — Elbuz asks for the amount: the whole blocked amount by default, or you can enter less. After capture, the payment is recorded in the document the same way as without a hold: status, cash receipt and fiscal receipt for the captured amount. NovaPay unblocks the difference for the customer itself.
    • “Release hold” — the money is unblocked on the customer's card, and the status becomes “Canceled”. Nothing is recorded in the document, and there are no cash documents.
    • “Refresh status” — requests the status from NovaPay. If the customer paid but the notification didn't reach Elbuz, the payment is recorded.
    “Release hold” can't be undone. A hold can be captured only once: after a partial capture, the rest is already unblocked for the customer, and captured money can be returned only through “Refund”. NovaPay releases a hold that isn't captured within 29 days on its own.

    If the order got smaller after a partial capture, correct the document's items: the payment is recorded for the captured amount, while the document total stays as it was.

    How to refund the customer

    The “Refund” button appears in the “Payment in NovaPay” block when the payment is paid or the hold is captured and there's something to refund. Elbuz asks for the amount: by default everything that can be refunded, or you can enter less. The next refund is for the remainder.

    After a refund:

    • a posted “Cash payment” for the refund amount is created and linked to the document;
    • “Paid” in the document decreases by this amount;
    • the document's payment status is “Partially refunded”, or “Refunded” if everything was returned. The block shows “Partially refunded” or “Refunded”, a “Refunded” line and, while something is left, “Refundable”.
    A refund can't be undone. NovaPay accepts refunds up to 30 days after payment. A PRRO refund receipt isn't issued automatically — issue it from the document (how to issue a refund receipt).

    A refund made in the NovaPay account, bypassing Elbuz, isn't recorded as a cash payment. The block shows “Refunded”, but you correct the cash document and the document amount by hand.

    Every money operation leaves a line in the document history, for example “Refund: 500.00 UAH, NovaPay — done” or “… — error (…)”. If the connection drops in the middle of an operation, Elbuz offers “Retry”, and a retry doesn't move the money a second time (breakdown).

    What to do when a link or payment fails

    Common problems
    What you seeWhyWhat to do
    “NovaPay: the buyer phone (+380XXXXXXXXX) is required — fill in the phone in the document” There's no Ukrainian number in the document, for the payer or for the contact Enter the customer's phone in the document and create the link again (NovaPay conditions)
    “NovaPay: currency … is not supported (UAH)” The document isn't in hryvnias Choose another service for this document (services and currencies)
    NovaPay isn't in the “Payment service” list, or it's grayed out with the “keys not set up” note “Active” is off. A grayed-out “keys not set up” row means the Merchant ID isn't entered or the saved key can't be read Open the “Connecting NovaPay” form: the red banner shows what's missing; paste the whole key again (connection)
    “The previous NovaPay link was paid with a hold. Capture or release the hold…” The customer has already paid the previous link, and the money is on hold Capture or release the hold in the “Payment in NovaPay” block, then create a new link (hold)
    “Could not close the previous NovaPay link, so no new one was created…” NovaPay didn't respond when Elbuz was canceling the old link Create the link again a bit later (link)
    The customer paid, but the document has no payment The hold is on, or the NovaPay notification didn't arrive Check the status in the “Payment in NovaPay” block: “Hold” — capture the hold; otherwise click “Refresh status”
    “It is unknown whether the operation went through. Click “Retry”: the money will not move a second time” The connection dropped during a capture or refund Click “Retry” or “Refresh status” — the money moves only once (refund)

    Scenarios

    Card prepayment for an invoice

    What to do. The hold is off. In an invoice for UAH 1,200 with the customer's phone, click “Payment link”, choose NovaPay and send the link in a messenger.

    What you get. After payment, the invoice is “Paid” and has a posted cash receipt. If the cash register switch is on, there's also a fiscal receipt with the “NovaPay” payment form.

    Part of the order wasn't found in stock

    What to do. The hold is on; the customer paid an order of three items for UAH 2,400 — status “Hold”. Two items for UAH 1,600 were found: “Capture hold”, amount 1,600, and remove the third item from the order.

    What you get. The document shows a UAH 1,600 payment with a cash receipt and fiscal receipt, and NovaPay unblocks UAH 800 for the customer.

    The order was canceled before shipping

    What to do. Status “Hold” → “Release hold”.

    What you get. Status “Canceled”; the customer's funds are free again, with no cash documents or receipts.

    The customer returned part of the goods

    What to do. UAH 1,600 was paid, and goods worth UAH 500 were returned: “Refund”, amount 500.

    What you get. A cash payment for UAH 500, paid UAH 1,100, status “Partially refunded”. Issue the refund receipt from the document by hand.

    FAQ

    Does the customer's money go through Elbuz?

    No. You work under your own NovaPay contract with your own key — the money goes straight to your account.

    Does NovaPay “Safe Purchase” work with delivery?

    No. The hold in Elbuz isn't tied to delivery; Nova Poshta waybills are created by the delivery module with your key (Nova Poshta).

    Do LiqPay or monobank have holds and refunds?

    No, among payment link services only NovaPay can capture holds and refund from the document card. With other services, refunds are made in their own account.

    The payment notification arrived twice. Will the amount double?

    No. Each transaction is recorded in the document once.

    Why doesn't a manager see the “Capture hold” and “Refund” buttons?

    The money buttons require the “Payment operations: refund, hold, credit” right of the documents window. By default only administrators have it; the block and “Refresh status” are visible to everyone with access to documents.

    Can I change the amount of a link that's already created?

    No. Correct the document and create a new link — it will be for the new remaining amount, and Elbuz cancels the old unpaid one in NovaPay.

    Where it is and who has access

    Menu
    invoice or customer order: the “Payment link” button, the “Payment in NovaPay” block
    Connection
    external services settings, NovaPay payment service
    Access right
    capturing, releasing a hold and refunds — “Payment operations: refund, hold, credit”
    Prepare
    a NovaPay internet acquiring contract, Merchant ID and private key; the customer's phone in the document

    Related topics

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free