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

curl --request POST \
  --url https://backendapi.sayswitchgroup.com/api/s2s/v1/ussd/initialize/wallet \
  --header "Authorization: Bearer YOUR_SECRET_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "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.