Overview
Monei allows you to save payment methods for faster, more convenient deposits. This guide covers adding, managing, and using saved payment methods. What you’ll learn:- Payment method types
- Adding and verifying payment methods
- Using saved methods for deposits
- Managing and deleting payment methods
- Security best practices
Payment Method Types
Monei supports multiple payment method types:Virtual Account
Dedicated bank account for transfers
Debit/Credit Card
Save card for instant deposits
USSD
Quick deposits via USSD code
Get All Payment Methods
Retrieve all saved payment methods for a subwallet.Add Payment Method
Add Card
Add USSD Method
Get Payment Method Details
Retrieve detailed information about a specific payment method.Set Default Payment Method
Mark a payment method as default for faster deposits.Only one payment method can be default at a time. Setting a new default automatically unsets the previous one.
Use Payment Method for Deposit
Deposit using a saved payment method.- Faster deposits (no need to re-enter card details)
- Secure storage
- One-click payments
- Automatic CVV verification
Delete Payment Method
Remove a saved payment method.Payment Method Status
Payment methods can have different statuses:| Status | Description | Can Use? |
|---|---|---|
ACTIVE | Ready to use | Yes |
INACTIVE | Temporarily disabled | No |
PENDING_VERIFICATION | Awaiting verification | No |
SUSPENDED | Suspended by system | No |
Payment Method Capabilities
Each payment method has specific capabilities:- Virtual Account
- Card
- USSD
- Crypto Wallet
Capabilities:
- Deposit: ✓
- Withdrawal: ✗
- Recurring: ✓
- Regular deposits
- Large amounts
- Bank transfers
Security Features
Encrypted Storage
Encrypted Storage
How we protect your data:
- End-to-end encryption
- PCI DSS compliant
- Tokenized card storage
- No plaintext storage
- Regular security audits
- Last 4 digits of card
- Expiry date
- Card brand
- Token reference
- Full card number
- CVV/PIN
- Unencrypted data
Authentication
Authentication
Required for sensitive operations:
- Adding payment method: API key
- Using payment method: API key + OTP (if required)
- Deleting payment method: API key
- Updating default: API key
- 3D Secure for cards
- OTP verification
- Device fingerprinting
- IP whitelisting (enterprise)
Monitoring
Monitoring
Automatic fraud detection:
- Unusual transaction patterns
- Multiple failed attempts
- Suspicious device/location
- Velocity checks
- New payment method added
- Payment method used
- Failed authorization
- Suspicious activity
Compliance
Compliance
Regulatory compliance:
- PCI DSS Level 1
- CBN regulations
- GDPR compliant
- KYC/AML checks
- Enable/disable methods
- Delete anytime
- View usage history
- Export data
Best Practices
Use Nicknames
Give descriptive names to easily identify payment methods
Set Default
Mark your most-used method as default for faster deposits
Review Regularly
Check saved methods and remove unused ones
Monitor Usage
Track usage count and last used date
Keep Updated
Update expired cards before they fail
Enable Notifications
Get alerts when payment methods are used
Common Issues
Card Declined
Card Declined
Problem: Card payment fails during depositCommon causes:
- Insufficient funds
- Expired card
- International card restrictions
- Daily limit exceeded
- Card not enabled for online transactions
- Verify card balance
- Check expiry date
- Contact your bank to enable online transactions
- Try a different card
- Use bank transfer instead
Payment Method Not Working
Payment Method Not Working
Problem: Cannot use saved payment methodChecks:Solutions:
- Ensure status is ACTIVE
- Check if enabled
- Verify capabilities
- Re-sync payment methods
- Delete and re-add
Missing Payment Methods
Missing Payment Methods
Problem: Payment methods not showingSolutions:
-
Sync payment methods:
-
Check correct subwallet:
- Verify API key permissions
Next Steps
Deposits
Use payment methods to fund your wallet
Payouts
Send money from your wallet
Security Guidelines
Learn security best practices
Webhooks
Get real-time payment notifications

