Sign in

Payments

Push payment requests

View as Markdown

In a nutshell

How to send a payment request directly to a Paystack Terminal.

Use this guide alongside Your First Terminal Integration, which covers the base flow: create a payment request, confirm the terminal is online and available, push the request, and handle charge.success. This page covers the checks to add before you go live.

Copy linkVerify delivery to the device

  1. Query terminal event status after the push.
  2. Confirm that the device actually received the event before assuming the customer saw it.
  3. Complete delivery checks within 48 hours of initiating the event, because event receipt can only be confirmed during that window.

Copy linkListen for payment notifications

Besides charge.success, listen for these events:

  • paymentrequest.pending
  • paymentrequest.success
  • invoice.payment_failed

Treat charge.success as the transaction success signal and paymentrequest.success as the successful invoice/payment-request confirmation.

Copy linkHandle delayed confirmation

  1. Wait for Paystack’s webhook retries if your system is temporarily unavailable.
  2. Expect retries for up to 72 hours.
  3. Verify the payment request directly if you still do not receive an event after that retry period.

This flow works well when the payment amount is known at checkout time and the terminal should start the payment immediately after the merchant triggers it.

Was this page helpful?