Accept PaymentsServer to ServerWallet-Specific APIsUSSD Payment With Wallet

Initialize S2S USSD Payment With Wallet

Initialize a USSD payment that settles into a selected NGN wallet.

Endpoint

POST /api/s2s/v1/ussd/initialize/wallet

Request Body

{
  "amount": "5000",
  "currency": "NGN",
  "email": "customer@example.com",
  "reference": "S2S_WALLET_USSD_001",
  "bankCode": "000013",
  "wallet_code": "NGN169XXXX"
}

Required Fields

FieldDescription
emailCustomer email address
amountPayment amount
referenceUnique transaction reference
bankCodeUSSD bank code
wallet_codeTarget NGN wallet code

Optional Fields

{
  "name": "Customer Name",
  "first_name": "Test",
  "last_name": "Customer",
  "bvn": "optional"
}

Important Notes

  • Use bankCode, not bank_code.
  • Minimum amount is NGN 100.
  • Only NGN is allowed.
Bank Transfer With WalletWallet-To-Wallet Transfer