Deposits

Get customer deposit details

Get bank deposit details for a KYC-verified customer.

GET
/api/v2/customers/{customerId}/deposit

Returns bank deposit details for a KYC-verified customer. The customer must have completed KYC verification to access deposit details.

Authorization

bearerAuth
AuthorizationBearer <token>

Organization API key obtained on Settings > API Keys page in Compose UI.

In: header

Path Parameters

customerId*string

Unique identifier of the customer

Query Parameters

paymentRail?string

Optional payment rail for deposit instructions. When omitted, currency=eur maps to SEPA and currency=usd maps to FEDWIRE. Use SWIFT for USD SWIFT deposits.

Value in"SEPA" | "FEDWIRE" | "SWIFT"
currency?string

Currency for the deposit rail. Supported values: EUR (SEPA) and USD (FEDWIRE). Use paymentRail=SWIFT for USD SWIFT deposits.

Value in"eur" | "usd"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET 'https://compose.finance/api/v2/customers/{customerId}/deposit?currency=eur' \  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "customerId": "550e8400-e29b-41d4-a716-446655440001",
  "currency": "eur",
  "paymentRail": "SEPA",
  "reference": "A7B3C9D2E1",
  "accountName": "AAA Corp.",
  "accountAddress": "123 Example St., 00-001 Warsaw, Poland",
  "iban": "DK0012345678123456",
  "bic": "DUMMYBICXXX",
  "bankName": "Dummy Bank",
  "bankAddress": "1 Placeholder Rd, Test City, 12345, Country",
  "bankCountry": "Denmark",
  "depositInstructions": "To deposit funds, simply transfer money from your bank using your reference and the bank details below.",
  "warning": "Include your unique reference in the transfer details",
  "thirdPartyEnabled": false,
  "depositModel": "reference"
}

{
  "error": "Missing required query parameter: paymentRail"
}

{
  "error": "Unauthorized - Invalid or missing API key or session"
}

{
  "error": "Customers feature is not enabled for your organization"
}

{
  "error": "Customer not found"
}

{
  "error": "Internal server error"
}

Update customer wallet PATCH

Updates the destination wallet address for customer on-ramp transfers.

Claim developer fees POST

Initiates a transfer of your accumulated developer fees to your organization's wallet. **Claim Process** 1. Request to claim developer fees is received. 2. Transfer is initiated to your organization's wallet. 3. Transaction status can be monitored via the returned transaction ID 4. Balance updates when the on-chain transfer completes