Skip to main content
POST
Deposit to wallet

Overview

POST /wallets/deposit moves funds between two wallets you own, applying currency conversion and a fee. The sourceWallet is debited by totalAmount (amount + feeAmount); the destinationWallet is credited by the converted amount. This endpoint is used to internally rebalance your wallets — for example, to convert XAF you collected into USD before issuing cards.
Note: This endpoint is not a customer-facing payment endpoint. To charge a mobile-money account use POST /payment/collect or POST /wallets/fund.

When to use it

  • Convert an XAF/XOF/CDF balance to USD so you can issue cards.
  • Internally rebalance funds between currency-segregated wallets you own.

Prerequisites

  • Both sourceWallet and destinationWallet belong to your company.
  • The sourceWallet has at least totalAmount available.
  • You have a valid current exchange rate — typically obtained via POST /company/exchange-rates/convert.

Request

Headers

Body

Response

200 — Deposit successful

Error responses

Code examples

cURL
Node.js (axios)

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Wallet-to-wallet transfer with currency conversion. The amount is debited from the source wallet (including fees) and the converted amount credited to the destination wallet.

sourceWallet
object
required
destinationWallet
object
required
exchangeRate
object
required

Response

Deposit successful

success
boolean
Example:

true

statusCode
integer
Example:

200

message
string
Example:

"Data retrieved successfully"