API reference · Moving money

Deposits

POST/depositDeposit into an account

POST Deposit into an account

POST /deposit

Resolves the receiver, obtains a quote, and posts the deposit to the ledger. An optional Idempotency-Key header makes a retried call with the same key return the original result instead of depositing again.

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live
`Idempotency-Key`	Reuse the same value on every retry of this request
`Content-Type`	application/json

Example

Request body: DepositRequest · Response: DepositResponse

curl -X POST "https://api.bridgemoni.com/deposit" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Idempotency-Key: a-unique-key-per-intent" \
  -H "Content-Type: application/json" \
  -d '{
    "receiverType": "ACCOUNT_NUMBER",
    "receiverValue": "text",
    "amount": 250000.0,
    "currencyCode": "NGN",
    "narration": "March payroll"
  }'

{
  "receiverType": "ACCOUNT_NUMBER",
  "receiverValue": "text",
  "amount": 250000.0,
  "currencyCode": "NGN",
  "narration": "March payroll"
}

{
  "data": {
    "depositReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "destinationAccountNumber": "0123456789",
    "amount": 250000.0,
    "netAmount": 250000.0,
    "currencyCode": "NGN",
    "status": "PENDING",
    "accountsTransactionReference": "financial transaction reference",
    "timestamp": "2027-03-14T14:30:01"
  },
  "description": "Deposit into an account"
}

Responses

Status	When
`200`	Deposit processed successfully

Generated from the OpenAPI document. Branch on the HTTP status: there is no machine-readable error code on the wire. Errors