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.
Open Integrations
Go to Settings → Integrations and find AddPay.
Enter your numbers
Click Connect, then enter your Merchant Number and Store Number.
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.
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.
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"
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.
Open the invoice
Open the invoice, go to its payments, and click Capture a payment.
Choose Card machine
Select Card machine as the payment method, then choose the machine.
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.
Get paid online with payment links
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:
| Message | What to do |
|---|---|
| The card was declined | Ask your customer to try another card. |
| The charge timed out on the machine | Send the charge again. |
| The charge was cancelled on the machine | Send it again when your customer is ready. |
| Payment received on a cancelled invoice | The invoice was cancelled while the customer paid. Refund your customer. |
| This charge needs review | Contact 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.