Initialize S2S OPay Payment With Wallet

Initialize an S2S OPay payment that settles into a selected NGN wallet.

Endpoint

POST /api/s2s/v1/transaction/opay/initialize/wallet

Request Body

curl --request POST \
  --url https://backendapi.sayswitchgroup.com/api/s2s/v1/transaction/opay/initialize/wallet \
  --header "Authorization: Bearer YOUR_SECRET_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "amount": 5000,
    "email": "customer@example.com",
    "reference": "S2S_OPAY_WALLET_001",
    "first_name": "Test",
    "last_name": "Customer",
    "callbackUrl": "https://example.com/callback",
    "wallet_code": "NGN169XXXX"
  }'

Required Fields

FieldDescription
emailCustomer email address
amountPayment amount
wallet_codeTarget NGN wallet code

Optional Fields

FieldDescription
referenceMin 10, max 33 characters
first_nameCustomer first name
last_nameCustomer last name
callbackUrlRedirect URL after payment

Important Notes

  • Use callbackUrl, not callback_url.
  • Do not send currency. OPay wallet-specific collection is NGN.
  • If callbackUrl is not sent, SaySwitch uses the merchant callback URL configured on the dashboard.