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

{
  "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

Field	Description
`email`	Customer email address
`amount`	Payment amount
`wallet_code`	Target NGN wallet code

Optional Fields

Field	Description
`reference`	Min 10, max 33 characters
`first_name`	Customer first name
`last_name`	Customer last name
`callbackUrl`	Redirect 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.

Card Payment With Wallet Bank Transfer With Wallet