Payments
Push payment requests
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
- Query terminal event status after the push.
- Confirm that the device actually received the event before assuming the customer saw it.
- 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.pendingpaymentrequest.successinvoice.payment_failed
Treat charge.success as the transaction success signal and paymentrequest.success as the successful invoice/payment-request confirmation.
Copy linkHandle delayed confirmation
- Wait for Paystackβs webhook retries if your system is temporarily unavailable.
- Expect retries for up to 72 hours.
- 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?