Skip to main content
POST
Transfer NGN for free between customer wallets
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
A unique transfer reference. Do not reuse a reference from a failed, reversed, cancelled, or otherwise completed transfer.
string
required
A non-empty transfer narration or description, up to 255 characters. It may match your reference, but it does not need to.

Request Example

Response

No transfer fee is charged for a successful wallet-to-wallet transfer.
string
success when the synchronous wallet transfer completes.
number
HTTP status code. Successful submission currently returns 201.
string
Human-readable response message

Response Example

Errors

Confirm that both account numbers belong to customers under your business before initiating the free internal transfer. If a successful request is retried with its original reference, FossaPay returns the existing successful result without moving funds again.

Authorizations

x-api-key
string
header
required

Body

application/json
fromAccount
string
required
toAccount
string
required
amount
number
required
reference
string
required
narration
string
required
Required string length: 1 - 255
Pattern: .*\S.*

Response

Wallet transfer completed

status
string
required
Allowed value: "success"
statusCode
integer
required
message
string
required