Skip to main content
The Unzer integration connects your Unzer account to Chatarmin CX. When a customer bought on invoice (Rechnungskauf) or in installments (Ratenkauf), your team sees the payment behind the order inside the ticket — including the bank details and the reference the customer needs — instead of opening the Unzer Merchant Portal in another tab.
Unzer shows up in the customer panel on a ticket. It does not create tickets or send notifications. The card itself only ever reads. An AI Agent can additionally delay dunning once on a payment, but only if you add that action to it, and it asks you for approval before anything happens — see Use Unzer in AI Agents.

When to use it

Use Unzer when you sell on invoice or in installments through Unzer and your team often handles:
  • “Did my invoice go through?” and “Which account do I pay into?”
  • “What reference do I put on the transfer?”
  • “I can’t pay before payday — can you hold the reminders?”
  • Refund and return questions where somebody needs to know what was actually charged

What the card can and cannot tell you

Unzer’s API reports what your shop charged, not whether the customer has paid. It exposes no due date and no settled flag. So the card says Charged and Left to charge, and never Paid. A payment that reads “Charged €59.90, left to charge €0.00” means Unzer captured the invoice for you — the customer’s transfer may still be on its way. Whether a customer has actually paid lives in Unzer Insights and in the reconciliation files Unzer sends you, not in this card.

Set it up

You need the private key of your Unzer account. You already have one if you take payments through Unzer; it is in Unzer Insights under your API keys. Connecting takes about two minutes and needs no approval from Unzer.
1

Copy your private key from Unzer

In Unzer Insights, open your API keys and copy the private key. It starts with p-priv- for your live account, or s-priv- for a sandbox account.The public key (p-pub-/s-pub-) is for checkout pages and does not work here.
2

Open integrations

Open integrations from your workspace settings and choose Unzer.If Unzer is not listed, contact your Chatarmin CX account team to enable it for your workspace.
3

Connect your Unzer account

Click Connect, paste the Private Key, and save. Chatarmin CX checks it with Unzer before saving. If Unzer rejects it, you see the reason and nothing is saved.You do not pick an environment. The key says which one it belongs to, so a sandbox key always talks to the sandbox.

Use Unzer in the inbox

When Unzer is connected, an Unzer card appears in the customer panel on a ticket. Expand it to see the payments behind the contact’s most recent orders, newest first — up to three. For each payment the card shows:
  • The state Unzer reports: charged, partly charged, pending, cancelled, in review or chargeback
  • The total, what has been charged, what is left to charge, and any cancelled or refunded amount
  • The bank details for an invoice transfer: IBAN, account holder, and the payment reference — both one click to copy
  • Dunning delayed, when the one delay Unzer allows has already been used
  • Unzer’s payment id, so you can quote it to Unzer support
The bank account shown is Unzer’s, not the customer’s. It is the same account printed on the invoice the customer already has.

When the card shows nothing

The card needs to know which orders belong to the contact, and the Unzer reference lives on the Shopify order. It will be empty where that link does not exist — most often on social DMs, and on orders from a shop that is not connected to Chatarmin CX.

Use Unzer in AI Agents

Add Unzer actions to an AI Agent and select the Unzer connection each may use. Two are available, and you choose which ones the agent gets: Enable Get Unzer payment alongside your Shopify Get order action. The agent takes the Unzer reference from the order it just read; it has no other way to find the payment.
Unzer allows one dunning delay per payment and refuses a second. The agent checks before it writes and tells you when a delay has already been used, rather than failing in front of the customer.
Three limits are built in and cannot be configured away:
  • Chatarmin CX checks every payment reference against the orders of the ticket’s contact before it calls Unzer. A reference from anywhere else is refused, on the read and on the write, even after you approve it.
  • A delay whose answer is lost — a timeout, an outage — is reported as an unknown outcome rather than a plain failure, and the agent is told to re-read the payment before trying again, because a second attempt would be refused.
  • In a test run, no write reaches Unzer at all; it is simulated.
Tell your agent in its instructions that “charged” is not “paid”. The action says so too, but your own wording is what the customer ends up reading.

Data and access

For each lookup, Chatarmin CX sends Unzer only the payment reference recorded on the order. Your private key is stored encrypted and is never shown again after saving. Nothing is written to Unzer unless you add the Delay Unzer dunning action to an AI Agent. That is the only write this integration can make; it is approval-gated by default, and every one is recorded on the run with the payment involved — never the customer’s details.
An Unzer private key is not read-only: it is the same key that can charge and refund. Chatarmin CX only ever authenticates, reads a payment and its transaction, and makes the one dunning-delay write — but treat the key as you would any payment credential, and rotate it in Unzer Insights if it is ever exposed.

Change or disconnect Unzer

To change a connection, click it in integrations. Leave Private Key blank to keep the current one. To disconnect, open the connection’s Connected menu, choose Disconnect, and confirm Delete. The Unzer card disappears from tickets, and any AI Agent actions using this connection stop working. Your payments and your Unzer account are not changed.

Troubleshooting

The connection won’t save

  • Check that the key is copied in full, without spaces.
  • Make sure it is the private key (p-priv- or s-priv-), not the public one.
  • If Unzer answers that it is unavailable rather than rejecting the key, that is an Unzer outage. Try again shortly; nothing was saved.

The connection says it needs reconnecting

Rotating or deleting the key in Unzer Insights invalidates it. Copy the new private key and enter it on the connection.

The card shows a payment, but the customer says they paid

Expected — see What the card can and cannot tell you. Unzer does not report the customer’s transfer here. Check Unzer Insights or your reconciliation file before telling a customer their invoice is closed.

The agent says it cannot find the payment

The agent needs the reference from the Shopify order. Check that the Shopify Get order action is enabled on the same agent, and that the order was actually paid through Unzer — orders paid by card or PayPal carry no Unzer reference. If none of this helps, contact Chatarmin CX support. Include the ticket link and the Unzer payment id, but never your private key.