Paystack — verify payment

Confirm whether a payment reference actually succeeded.

What it does

Confirms whether a payment reference actually succeeded. Never trust a customer's word or a redirect for this — a reference is only real once Paystack says so.

What you need

Secret key from Paystack. Paystack → Settings → API Keys & Webhooks. The secret key, not the public one — the public key cannot read transactions.

Connecting it

Credentials belong to one project, not to your workspace and not to you. A system built for one client never runs on another client's account, and a package handed to a business runs on theirs.

Open the project and stay on the Visual Editor tab.
Open the Tools & Integrations rail on the right.
Find this tool, open it, and paste the credential.

To change it later, open the same panel — you can leave the key blank to keep the stored one and change only the other field.

Using it in a step

An Action step runs one tool with the arguments you type, exactly as written, with no model involved — so it costs nothing per run and behaves the same every time. Add one from the canvas toolbar, choose Paystack — verify payment, and fill in:

Field	Required	What goes in it
`reference`	yes	The transaction reference from checkout. Test references need a test key.

Values can carry results forward: {{previous}} is the step before, and {{row:column}} is a column from the row this run is about when the trigger fans out.

Press Try it to run the step on its own before committing to a whole sequence.

Using it with an agent

Tick Paystack — verify payment on any agent that should be able to call it, and the agent decides when to. Use an agent when the judgement matters and an Action step when the certainty does.

A worked example

An online shop takes an order. Before the warehouse is told to pack it, this step verifies the reference. Anything not success goes to a human instead of the packing list.

When it goes wrong

It says the reference does not exist. Test-mode references cannot be verified with a live key, and the reverse. Check which key is connected on this project.