Deposit Flows - HopNow API

Money reaches an account in one of three ways.

Deposit type	Where the money lands	Where the payer’s details come from
Bank transfer to the trading account	The trading account	Deposit Instructions
Bank transfer to a virtual account	That virtual account’s balance	The virtual account object: Get Virtual Account
Crypto	The trading account	The wallet’s `address`: Create Wallet

Bank transfers to the trading account

List Deposit Instructions returns the bank details used to fund your trading account. An account can have multiple deposit instructions for the same currency. Select an instruction for the currency and payment rail you need.

Payment references

Check the selected instruction’s memo field before sharing the bank details:

`memo`	Account arrangement	Instructions for the payer
`null`	Dedicated account number or IBAN	Use the returned bank details. No Hop payment reference is required.
Contains a value	Shared bank account; the memo identifies your trading account	Include the exact `memo` value in the bank transfer’s payment reference.

When memo contains a value, display it as a required payment reference alongside the bank details. A missing or altered reference can delay crediting the deposit. The instruction’s id identifies the API record. The payment reference is the returned memo value. A dedicated-account entry (abridged; the full object is on List Deposit Instructions):

{
  "id": "fi_2d8b4f6a0c3e791b5d2a8f4c",
  "object": "deposit_instruction",
  "account_id": "acct_9f2a7c1e6a2b4f3c9b8d2e5a",
  "currency": "EUR",
  "status": "active",
  "beneficiary_name": "Hop Innovations Inc",
  "iban": "DE89370400440532013000",
  "swift_bic": "DEUTDEFF",
  "memo": null,
  "supported_rails": ["sepa", "swift"]
}

A shared-account entry; the memo identifies you:

{
  "id": "di_6a0c3e7d91b5f2a8c4e0b7d3",
  "object": "deposit_instruction",
  "account_id": "acct_9f2a7c1e6a2b4f3c9b8d2e5a",
  "currency": "USD",
  "status": "active",
  "beneficiary_name": "Hop Innovations Inc",
  "account_number": "1234567890",
  "routing_number": "021000021",
  "memo": "ACCT9F2A7C1E6A2B4F3C9B8D2E5A",
  "supported_rails": ["ach", "fedwire"]
}

One currency at a time

Get Deposit Instruction returns the account’s default entry for one currency. A currency that is not enabled for the account comes back with status: "unavailable"; contact Hop to enable it.

Rails

Which rails a payer can use depends on the currency:

Currency	Rails
`USD`	ACH, ACH_SAME_DAY, RTP, Fedwire, SWIFT, FEDNOW
`EUR`	SEPA, SEPA Instant, SWIFT
`GBP`	Faster Payments (FPS) , SWIFT
Every other currency	SWIFT

For the exact methods one bank account accepts, use supported_rails from the selected deposit instruction. The field uses these values:

`supported_rails` value	Payment method
`ach`	ACH
`fedwire`	Fedwire
`swift`	SWIFT
`sepa`	SEPA
`spei`	SPEI
`pix`	PIX
`faster_payments`	Faster Payments (FPS)

For outgoing payments, use the separate payment_rail parameter on Create Payout.

The flow

Read the deposit instructions and pick the entry for the currency you want.
Give the payer the beneficiary name, the bank details and, when memo is set, the memo.
When the money arrives you receive a payin.received webhook and the trading account updates.

Bank transfers to a virtual account

A virtual account has its own bank details, returned on the virtual account object once it is provisioned: beneficiary_name, bank_name, account_number or iban, swift_bic and routing_number. The deposit credits the virtual account’s own balance and raises payin.received with deposit_destination.type set to virtual_account. Opening virtual accounts is covered in Virtual accounts.

Crypto deposits

Create Wallet with the currency and network. The response carries the deposit address.
Share the address. The payer sends some amount of the currency on the wallet network to the address.
When the transaction confirms you receive a payin.received webhook and the trading account updates.

Networks available in production:

Network	`USDC`	`USDT`
`ethereum`	✓	✓
`solana`	✓	✓
`bsc`	✓	✓
`polygon`	✓	✓
`avax`	✓	✓
`tron`		✓
`xlm`	✓
`base`	✓

Sandbox networks and test funds are covered on Testing.

​Bank transfers to the trading account

​Payment references

​One currency at a time

​Rails

​The flow

​Bank transfers to a virtual account

​Crypto deposits