Sign in

Payments

USSD

View as Markdown

In a nutshell

Reference information for USSD payments on Paystack.

USSD is a phone-led payment channel for Nigerian customers. It lets a customer complete payment by dialing a short code on their mobile device and authorizing the charge with their bank-issued PIN.

Copy linkSupported market

USSD payments on Paystack are available for Nigeria.

Copy linkHow the channel works

When a USSD charge is created, Paystack returns a USSD instruction for the customer to dial. The code is in the familiar *...# format. After dialing, the customer authenticates the transaction with a PIN through their bank’s USSD flow.

The initial Paystack response creates the payment, but confirmation is asynchronous. The final outcome is sent through the merchant’s webhook URL as a charge.success event when payment succeeds.

Copy linkSupported bank codes

The payment channels guide currently documents the following supported USSD type:

BankUSSD type
Guaranty Trust Bank737

Copy linkTransaction characteristics

AttributeBehavior
Customer inputEmail and amount to create the charge, then USSD authorization on phone
AuthenticationCustomer PIN inside the bank’s USSD flow
ConfirmationWebhook-based asynchronous confirmation
ReusabilityReturning customers are not charged from a saved USSD authorization

Copy linkTimeout behavior

The documented flow does not define a reusable authorization or instant terminal confirmation. A USSD charge remains an asynchronous payment that depends on the customer completing the bank’s USSD session and on Paystack receiving the final bank response. Because of that, webhook delivery is the authoritative signal for completion.

Was this page helpful?