Payments
Physical Terminal
In a nutshell
Understand what Paystack Terminal is and the core ideas behind Terminal integrations.
Paystack Terminal is how you accept in-person payments with a physical device. It uses the same account, APIs, and webhooks you already use for online payments, so you don't need separate infrastructure for face-to-face checkout.
You create a payment request from your server, send it to a terminal, and get the outcome back through webhooks. Paystack keeps the device connected, so you can check whether a terminal is online and available before you send it a request.
Copy linkIntegration flows
Terminal supports a few integration flows, depending on how your business collects payment:
- Push payment requests: send a payment request directly to a terminal at the point of sale, for cashier-led checkout.
- Invoice payments: create a payment request the customer pays later, by scanning a QR code or entering a reference on the terminal, for pay-on-delivery and other deferred-payment flows.
- Custom apps: build your own Android app on top of the Paystack terminal this is suited for businesses that want full control over the on-device experience.
Payment Channels
Terminal supports all the common payment methods: physical Cards, bank transfers, and QR Codes.
Copy linkKey terms
- Terminal device: the Paystack hardware that displays payment details and collects payment
- Payment request: the server-side instruction that defines what the customer should pay
- Push payment: a flow where the merchant sends a payment request directly to a specific terminal for immediate completion
- Invoice payment: a payment request that can be fetched later on a terminal using an offline reference or QR code
Copy linkWhat you need
Every integration needs:
- a Paystack Terminal device (apply for one if you don't already have it)
- a webhook endpoint that receives the final payment outcome
Start with Your First Terminal Integration to send your first payment request.