With Charge by link or QR the register generates a link and a QR code. The customer opens it on their phone and pays there. The register waits for the provider’s confirmation and only then records the payment.
What has been tested
The app includes five providers: Tilopay, Pagadito, Stripe, PayPal and Mercado Pago. The one tested end to end is Pagadito (in test mode). We don’t promise that the others work in a specific country: confirm with your provider that it can charge in your country and currency, and run a test payment before using it with customers.
What you need
- An account with the provider you choose, and its keys.
- Internet on the tablet (this kind of payment doesn’t work offline).
- An open shift on that tablet and permission to charge.
Set up a provider
- Go to Settings > Payment methods and find Link or QR payment.
- Choose the provider and type its keys:
| Provider | What it asks for |
|---|---|
| Tilopay | API user, API password, integration key |
| Pagadito | UID, WSK and the Test mode (sandbox) option |
| Stripe | Stripe key (starts with rk_ or sk_) |
| PayPal | Client ID, Client secret and test mode (sandbox) |
| Mercado Pago | Access token |
- Tap Save.
- Tap Test connection to check that the keys work.
- Turn on Offer at checkout so the provider shows up on the payment screen.
- If the provider allows it, choose the Charge currency.
Other buttons: Remove (deletes the provider) and View diagnostics (copies the latest calls to the provider, without the keys, in case you need to show them to support).
You can have several providers active at once; the cashier picks one when charging.
Keys are stored only on that tablet
Keys are stored encrypted only on the device where you type them. They are not shared with other tablets and are not included in backups. If you have several registers that charge by link, type the keys on each one. If you reinstall the app or restore a backup, the provider shows as “not configured” and you must type the keys again.
Some test-mode details: a Stripe key containing _test_ charges in test mode, and a Mercado Pago token starting with TEST- is a test token (one starting with APP_USR- charges for real).
Charging with a link or QR
- Build the order and tap Charge.
- Choose the provider: Charge (amount) with (provider).
- The screen Charge with (provider) opens with the QR code and the link. Show the QR to the customer or send them the link.
- The screen says Waiting for payment (provider). The register asks the provider every few seconds; you can also tap Check now.
- When the provider confirms the payment, the sale is recorded and you reach the receipt screen. See Charging.
To back out before the customer pays, tap Cancel charge.
If the customer takes a while: close and resume
You can tap Close and keep serving other sales. The link stays alive.
- The register shows A payment link charge is pending.
- Tap Resume and check to go back and see whether they have paid.
- The link expires after about 15 minutes. If nobody paid, the register says “The link expired without a payment.” and you can generate another one.
Watch list
The register keeps checking unresolved payments every 30 seconds. You will see these notices:
- Payment link pending: the customer hasn’t paid yet.
- Being watched: not yet known whether the customer paid: the register couldn’t confirm yet and keeps trying.
- Payment received but not recorded: the provider received the money but the register couldn’t record the sale (for example, the link had already expired). The register never records a payment without the provider’s confirmation. What to do: refund the money from the provider’s dashboard, then tap Mark as resolved.
While there are unresolved payments, you can’t change the credentials or remove the provider.
Errors and what to do
| Message | What to do |
|---|---|
| ”Open this device’s shift before charging by link.” | Open the shift on this tablet. See Shifts and cash drawer. |
| ”The provider did not accept the credentials. Check them in Settings, Payments.” | Check and retype the keys; use Test connection. |
| ”No connection to the provider. It retries on its own.” | Check the tablet’s internet; the register retries on its own. |
| ”The provider does not accept this currency for your business.” | Change the payment currency or check with the provider. |
| ”The amount is outside what the provider allows.” | The amount is too low or too high for that provider. Charge with another method. |
| ”The provider reports a payment that does not match the link amount. It was not recorded. See the diagnostics.” | No sale was recorded. Check the payment in the provider’s dashboard. |
| ”No payment methods are active. Turn them on in Settings, Payments.” | Turn on at least one way of charging. |