Skip to content
PiCortex Help

Using AddPay in PiCortex

Last updated 2026-10-27 · PiCortex Team

Once AddPay has approved your merchant account, you can connect it to PiCortex and start taking card payments. This article covers connecting your account, registering your card machines, and getting paid on POS, on invoices and online.

Haven't applied yet? Start with Getting Paid with AddPay.

Connect your AddPay account

You need two numbers from AddPay: your Merchant Number and your Store Number. Both come with your approved AddPay account. They're account numbers, not passwords.

1

Open Integrations

Go to Settings → Integrations and find AddPay.

2

Enter your numbers

Click Connect, then enter your Merchant Number and Store Number.

3

Connect

Click Connect. PiCortex checks your merchant number with AddPay and shows Connection Successful!.

PiCortex also shows your Webhook URL here. If AddPay asks for it while finishing your setup, copy it from this screen.

To see your connection later, go to Settings → Integrations → AddPay and click Manage. This page shows your merchant and store numbers and your card machines.

Register your card machines

Each AddPay card machine is registered to one of your stores. A machine only appears as the Card option on POS in the store it's registered to.

1

Open Card Machines

In Settings → Integrations → AddPay, click Manage, then go to Card Machines. You can also add a machine from the store's own page.

2

Add the machine

Add a card machine and fill in:

  • Serial Number: the serial printed on the machine, also shown in its device settings, for example WPHK002503000418
  • Store: the store where the machine is used
  • Label: a friendly name your cashiers will recognise, such as "Front counter"
3

Save

The machine is ready to take payments in that store straight away.

If a machine is replaced or no longer used, tick Retired rather than deleting it. This keeps the history of payments taken on it.

Who can manage card machines

Administrators, Finance and ESD users can add, change and retire card machines. Cashiers can use them but can't change them, so a till can't be pointed at another store's machine by mistake.

Take card payments on POS

On the payment screen, choose Card. Then tap Charge on card machine and Send to card machine. The amount goes straight to the machine and your customer taps their card. The order is marked as paid as soon as AddPay confirms the payment.

Charge an invoice on the card machine

You can also charge an invoice to a card machine from the web app, for example at a reception desk.

1

Open the invoice

Open the invoice, go to its payments, and click Capture a payment.

2

Choose Card machine

Select Card machine as the payment method, then choose the machine.

3

Send it

Click Send to card machine and ask your customer to tap their card.

When the payment goes through you'll see Payment received and the invoice is marked as paid. You can close the window while you wait: the invoice updates by itself once AddPay confirms the payment.

When AddPay is connected, an unpaid invoice you send by email carries a Pay now link, and the invoice PDF shows Pay online. Your customer clicks it and pays by card on AddPay's secure payment page. The invoice is marked as paid automatically.

A fresh payment page is created each time the link is clicked. That means the link still works if your customer opens the email weeks later. Paid or cancelled invoices don't offer the link.

While a customer has a payment page open, the invoice shows Payment link active, with when it expires. From there you can:

  • Copy link to send it again, for example on WhatsApp.
  • Cancel link if you'd rather charge the card machine instead.

If a card payment doesn't go through

Nothing is marked as paid until AddPay confirms the payment. If a payment fails, you'll see the reason:

MessageWhat to do
The card was declinedAsk your customer to try another card.
The charge timed out on the machineSend the charge again.
The charge was cancelled on the machineSend it again when your customer is ready.
Payment received on a cancelled invoiceThe invoice was cancelled while the customer paid. Refund your customer.
This charge needs reviewContact PiCortex support before taking another payment for it.

Disconnecting AddPay

Go to Settings → Integrations → AddPay and click Disconnect. Your card machines stay registered, but they can't take payments until you reconnect. You can't disconnect while a payment is still in progress.

Need help with AddPay?

Contact your PiCortex contact or PiCortex support.

Was this article helpful?

Still need help?

Contact us on WhatsApp and we'll assist you.

Using AddPay in PiCortex | PiCortex Help