Skip to main content
POST
Simulate an inflow
Sandbox only. Works on SIMULATED virtual accounts; call it with base URL https://sandbox.nomba.com. See Testing virtual accounts for the full flow and the rejection codes.

Authorizations

Authorization
string
header
required

Nomba authenticates API calls with OAuth2 HTTP bearer tokens. There are two methods of authentication; Client-Credentials method and PKCE (Proof Key for Code Exchange) method. Both methods return an access token. Send it in the Authorization header: Authorization: Bearer <access_token>.

Headers

accountId
string<uuid>
required

The parent accountId of the business.

Example:

"890022ce-bae0-45c1-9b9d-ee7872e6ca27"

Path Parameters

identifier
string
required

The account reference or account number of the SIMULATED virtual account.

Example:

"sandbox-va-001"

Body

application/json
amount
string
required

Amount to send, in naira. Must be greater than zero. Simulated accounts accept any amount.

Example:

"5000.00"

senderAccountName
string
required

The sender's account name. Checked against the virtual account name when restrictInflowToAccountName is true; word order doesn't matter.

Example:

"Scorsese Daniel"

senderAccountNumber
string

The sender's account number. Optional.

Example:

"0011223344"

senderBankCode
string

The sender's bank code. Optional.

Example:

"058"

narration
string

Transfer narration. Optional.

Example:

"Invoice 1042"

Response

The inflow was processed. Check data.status to see whether it was accepted.

code
string
required

Response Code

Example:

"00"

description
string
required

Response description

Example:

"SUCCESS"

data
object
required