Sign in

Payments

Physical Terminal

View as Markdown

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.

Was this page helpful?