Payments
Invoice payments on Terminal
In a nutshell
How to accept invoice-style payments on a Paystack Terminal.
Copy linkCreate or identify the customer
- Create a customer record before creating the invoice.
- Reuse an existing customer if one already exists.
- Store the returned
customer_codeandidafter customer creation.
Copy linkCreate the invoice
- Create the invoice with the Payment Request API.
- Choose a simple invoice when you only need to collect a total amount.
- Choose a professional invoice when you want the invoice to include line items, quantities, and unit prices.
- Save the returned
offline_referencebecause it identifies the invoice when the customer pays later.
Copy linkShare the payment identifier
- Send the customer the
offline_referenceby the channel that fits your flow. - Present it either as plain text or as a QR code.
- If you used a valid customer email, Paystack also emails the invoice automatically.
Copy linkAccept payment on the terminal
- Open the invoice payment flow on the terminal.
- Enter the
offline_referencemanually or scan the QR code that represents it. - Let the customer review the invoice details shown on the terminal.
- Complete payment on the terminal once the customer confirms the invoice.
Copy linkListen for payment updates
- Configure your webhook URL before going live.
- Listen for:
paymentrequest.pendingpaymentrequest.successcharge.successinvoice.payment_failed
- Reconcile the invoice in your system when the successful webhook arrives.
Use invoice payments when payment happens after order placement or fulfillment β pay-on-delivery, collect-on-delivery, vending, logistics, and other deferred-payment use cases. This approach keeps reconciliation tied to the original payment request instead of requiring manual matching when the customer pays later.
Was this page helpful?