Deposits

A deposit is any incoming transfer credited to one of your accounts. Augustus creates a deposit record when funds arrive on:

An operating account, using its rail-specific payment details (IBAN, sort code, ABA).
A stablecoin wallet, from a linked wallet on a supported chain.
A virtual account, whose payment details are issued in your customer’s name. See Virtual accounts.

You receive a webhook for every deposit. Reconcile or return it from there.

By default your account may not be enabled for inbound deposits and payments could be auto-returned. Turn off auto-returns under Settings → Money, or contact support to enable deposits on the accounts you want to receive funds on.

Stablecoin deposits

Copy your wallet address from the Dashboard under Accounts → Details. Senders must transfer from a linked wallet on a supported chain.

Verify the address, chain, and amount before sending. Transfers from non-linked addresses or unsupported chains may be lost.

Webhook events

Subscribe to the following events to be notified when deposits and returns change state:

Event	Description
`deposit.received`	A new deposit arrived on one of your accounts.
`return.initiated`	A return was initiated for a deposit.
`return.paid`	The return was processed successfully.
`return.failed`	The return could not be completed.
`return.returned`	A previously paid return was reversed or returned, and the funds were credited back to your account.

Retrieve a deposit

Get a deposit ID from the deposit.received webhook payload or by listing deposits.

2026-05-01
2023-01-01

import Augustus from '@augustusbank/typescript-sdk'

const client = new Augustus()
const deposit = await client.deposits.retrieve('your-deposit-id')

GET /v1/deposits/{id} in the API Reference →

import Ivy from '@getivy/node-sdk'

const client = new Ivy()
const deposit = await client.deposits.retrieve({ id: 'your-deposit-id' })

POST /api/service/deposit/retrieve in the API Reference →

Returns

A return sends a deposit back to the original sender. Returns reference the parent deposit and emit return.* webhook events as they progress.

Create a return

2026-05-01
2023-01-01

import Augustus from '@augustusbank/typescript-sdk'

const client = new Augustus()
const ret = await client.returns.create({
  deposit_id: 'your-deposit-id',
})

POST /v1/returns in the API Reference →

import Ivy from '@getivy/node-sdk'

const client = new Ivy()
const ret = await client.returns.create({
  depositId: 'your-deposit-id',
})

POST /api/service/return/create in the API Reference →

Retrieve a return

2026-05-01
2023-01-01

import Augustus from '@augustusbank/typescript-sdk'

const client = new Augustus()
const ret = await client.returns.retrieve('your-return-id')

GET /v1/returns/{id} in the API Reference →

import Ivy from '@getivy/node-sdk'

const client = new Ivy()
const ret = await client.returns.retrieve({ id: 'your-return-id' })

POST /api/service/return/retrieve in the API Reference →

FAQ

What happens if a deposit doesn't match what I expected?

With Deposits enabled, the payment is accepted and recorded as an unmatched deposit. Reconcile it in your own system or return the funds. Without Deposits enabled, mismatched payments may be returned automatically.

How do deposits affect my balance?

Each successful deposit immediately increases the account’s available balance. See Balances.

Can I partially return a deposit?

No — only full returns are supported. To send back a partial amount, use a payout.

Why are deposits in Test Mode not working?

By default, your account is set to auto-return funds. Turn off auto-returns under Settings → Money to receive test deposits.

Basics

Accounts

Incoming Payments

Outgoing Payments

On- / Off-Ramp

Loans

Stablecoin deposits

Webhook events

Retrieve a deposit

Returns

Create a return

Retrieve a return

FAQ

​Stablecoin deposits

​Webhook events

​Retrieve a deposit

​Returns

​Create a return

​Retrieve a return

​FAQ

Stablecoin deposits

Webhook events

Retrieve a deposit

Returns

Create a return

Retrieve a return

FAQ