Skip to main content
POST
Wallet-to-Wallet Transfer (Free)
Move funds instantly between two FossaPay NGN wallets belonging to customers under your business. Wallet-to-wallet transfers are free.
Use this endpoint only when both the sender and recipient are FossaPay customers created under the same business and both account numbers belong to their FossaPay NGN wallets.
To send money to an account at another bank, use the Inter-Bank Transfer endpoint instead.

Request

string
required
API Key for authentication
string
required
FossaPay NGN wallet account number belonging to the sending customer
string
required
FossaPay NGN wallet account number belonging to another customer under the same business
number
required
Transfer amount
string
required
Transfer reference
string
Transfer narration/description

Request Example

Response

No transfer fee is charged for a successful wallet-to-wallet transfer.
boolean
Indicates if the transfer was successful
string
Human-readable response message

Response Example

Error Codes

Rate Limit: 50 requests per minute
Confirm that both account numbers belong to customers under your business before initiating the free internal transfer.