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
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.
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.
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-ors-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.