This endpoint allows customers to pay for transactions, bill payments, wallet funding, or any other payable item using their wallet balance. The system automatically debits the customer’s wallet and updates the payment status.
Authentication
Authentication token obtained from login
Device UUID for request tracking
Platform identifier (e.g., “WEB”, “MOBILE”, “IOS”, “ANDROID”)
Request Body
Type of payable item to process Options:
TRANSACTION - Remittance/money transfer
WALLET - Generic wallet payment
WALLET_CUSTOMER - Personal wallet payment
BILL - Bill payment
MERCHANT - Product payment
WITHDRAWAL - Wallet withdrawal
Unique identifier of the payable item
Customer’s account password for authentication
Wallet account ID to debit from
Total amount to be debited including fees and taxes
Reference number for the payment (can be auto-generated)
Specific wallet account number (if customer has multiple accounts)
paymentAccountNumbeCurrencyCode Currency code of the wallet account Examples: USD, GBP, NGN, EUR
One-Time Password for Strong Customer Authentication (if enabled)
Transaction PIN for additional security (if enabled)
Code Examples
Use Cases
1. Pay for Money Transfer
2. Pay Bill from Wallet
3. Fund Another Wallet