While integrating against staging, you don’t need to send a real bank transfer to test your collection flow end-to-end — POST /api/simulate-funding fakes an inbound webhook from the payment provider as if your customer had actually paid.
This endpoint only works against staging/sandbox.

​
Usage

​
string
required
Currency of the wallet to credit.
​
number
required
Amount to simulate as received.
​
string
required
Should match the payRefrence memo from a prior POST /api/deposit call so the simulated payment reconciles against that transaction.
​
string
required
A unique ID for this simulated funding event.
1

Create a collection

POST /api/deposit as usual — note the payRefrence in the response.
2

Simulate the transfer

Call POST /api/simulate-funding with narration set to that payRefrence.
3

Confirm it landed

Poll GET /api/transaction/:paymentReference, or check that your webhook fired.