Referenced refunds

Return money to a customer’s original payment method by refunding the payment behind a credited invoice through your Payment Service Provider (PSP).

Why this matters

A credit note corrects the accounting, but if the customer already paid the original invoice, the money is still with you. A referenced refund closes that gap: it instructs the PSP to refund the original payment transaction, so the funds flow back to the payment method the customer paid with and the refund reconciles against the original payment in both your PSP and accounting systems.

A referenced refund is a refund of a specific earlier payment, tied to that payment’s transaction at the PSP. This is different from an un-referenced refund, which is a standalone payout to the customer that isn’t linked to any previous payment.

How it works

The refund action is called on the credit note, not on the original invoice. Solvimon looks up the payment of the original invoice (the invoice the credit note was created from) and submits a refund request for that payment to the PSP.

The refund only works on invoices that meet all of the following conditions:

Condition	Why
Type is `CREDIT`	The refund is triggered from the credit note, which defines the amount to return.
Status is `FINAL`	Draft credit notes can still change; only finalized ones can be refunded.
Not already paid	A refunded credit note is settled, so this guards against refunding twice.
The original invoice has at least one `AUTHORIZED` payment	There must be a PSP payment to reference. An invoice settled outside a PSP (for example by bank transfer) has no payment to refund against.

If any condition isn’t met, the refund action is rejected.

Refunding a credit note

Via API

First credit the invoice and finalize the credit note. Then call POST /v1/invoices/{id}/refund on the credit note. The request has no body:

POST

/v:version/invoices/:resourceId/refund

1 curl -X POST https://api.solvimon.com/v1/invoices/invo_NxHlr3Cwd8vkK7XX3Sh6/refund \
2      -H "X-API-KEY: <apiKey>"

Try it

The response is the credit note, linked to the original invoice whose payment is being refunded:

Response

1 {
2   "object_type": "INVOICE",
3   "id": "invo_NxHlr3Cwd8vkK7XX3Sh6",
4   "invoice_number": "CR-2026-0042",
5   "customer_id": "cust_AbD3DqausjOYiMNDZY11F",
6   "status": "FINAL",
7   "type": "CREDIT",
8   "created_at": "2026-07-02T09:15:00Z",
9   "updated_at": "2026-07-03T14:30:00Z",
10   "billing_currency": "EUR",
11   "invoice_amount_including_tax": {
12     "quantity": "-250.00",
13     "currency": "EUR"
14   },
15   "payment_status": "UNPAID",
16   "paid": false,
17   "linked_invoices_ids": [
18     "invo_MwGkq2Bvc7ujJ6YY2Rg5"
19   ]
20 }

The refund request is submitted to the PSP asynchronously. The PSP processes it and returns the funds to the customer’s original payment method on its own schedule.

Via Desk

Open the credit note and select the refund action from the invoice menu. The action is only shown when the conditions above are met.

Edge cases

Refunding twice: once a credit note has been refunded it counts as paid, and further refund attempts are rejected.
No PSP payment on the original invoice: if the original invoice was never paid through a PSP, there is no payment to reference. Settle the credit with the customer outside Solvimon, or refund a specific payment directly with POST /v1/payments/{id}/refund.