Create a deposit

Call POST /business/treasury/deposits with the deposit amount in integer cents of the deposit currency (defaults to ZAR).

Destination

`fundEasyCard`	After approval
`false` or omitted	Funds stay in your business treasury wallet (Fund my wallet)
`true`	Fund my EasyCard - convert fiat → USDC when needed, then fund the corporate EasyCard programme automatically

You still submit proof of payment and wait for ops approval. Auto-funding runs only after the deposit is approved. If conversion or programme funding fails, the deposit remains in treasury - retry with Trading and Fund and withdraw. The response includes:

id: deposit request identifier (use when submitting proof and polling status)
reference: unique reference the payer must include on the bank transfer
currency: fiat currency you are depositing (default ZAR)
fundEasyCard: whether Fund my EasyCard was requested
banks: bank accounts the payer can send fiat to

POST /business/treasury/deposits (wallet)

curl -s -X POST "https://b2b-api.easyonramp.com/api/v1/business/treasury/deposits" \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100000,
    "currency": "ZAR"
  }'

POST /business/treasury/deposits (Fund my EasyCard)

curl -s -X POST "https://b2b-api.easyonramp.com/api/v1/business/treasury/deposits" \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100000,
    "currency": "ZAR",
    "fundEasyCard": true
  }'

Response

{
  "id": "550e8400-e29b-41d4-a716-446655440003",
  "reference": "EZ9F2T7Q3MHB",
  "currency": "ZAR",
  "fundEasyCard": true,
  "banks": [
    {
      "id": "1",
      "bankName": "Example Bank",
      "accountNumber": "6281234567890",
      "accountHolder": "EasyOnRamp (Pty) Ltd",
      "swiftCode": "EXAMPLEZA",
      "country": "ZA",
      "currency": "ZAR"
    }
  ]
}

The live API returns the full accountNumber and bank details for the transfer. Values above are illustrative only.

Make the fiat transfer

Instruct your finance team or end user to wire fiat to one of the returned bank accounts. The transfer must include the reference so operations can match the payment to your deposit request.

Submit proof of payment

After the transfer is made, upload proof with POST .../proof as multipart/form-data (bankId + proof file). See Submit proof of payment. Until proof is submitted, the deposit has status waiting_pop and counts toward your treasury pending balance for that currency.

After approval

Wallet deposits (fundEasyCard: false): treasury is credited in the deposited currency. Use Trading to convert ZAR → USDC, then Fund and withdraw if you want programme spending power.
Fund my EasyCard (fundEasyCard: true): after approval, the platform converts to USDC when needed and calls corporate programme funding. Confirm with GET /wallet/balance or card.fund.completed.

Next step

Track approval with Deposit status. Poll includes fundEasyCard.

Get started

Core concepts

Common workflows

How to manage users

How to fund your business wallet

How to use cards

How to use reports

Integration services

Destination

Make the fiat transfer

Submit proof of payment

After approval

Next step

​Destination

​Make the fiat transfer

​Submit proof of payment

​After approval

​Next step

​Related

Destination

Make the fiat transfer

Submit proof of payment

After approval

Next step

Related