Update customer developer fees
Updates the developer fee configuration for the customer. These fees are deducted from customer deposits before USDC is sent to their wallet. **Fee Types** - `developerSpreadFeeBps`: Spread fee in basis points (0-2500, max 25%). Applied to the USDC amount. **Fee Calculation** ``` spreadFee = amount × spreadFeeBps / 10000 customerReceives = amount - spreadFee ``` **Example:** 1000 USDC deposit with 1% spread (100 bps) → customer receives 990 USDC
Updates the developer fee configuration for the customer. These fees are deducted from customer deposits before USDC is sent to their wallet.
Fee Types
developerSpreadFeeBps: Spread fee in basis points (0-2500, max 25%). Applied to the USDC amount.
Fee Calculation
spreadFee = amount × spreadFeeBps / 10000
customerReceives = amount - spreadFeeExample: 1000 USDC deposit with 1% spread (100 bps) → customer receives 990 USDC
Authorization
bearerAuth Organization API key obtained from PropelAuth
In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X PATCH 'https://compose.finance/api/v2/customers/{customerId}/developer-fees' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "developerSpreadFeeBps": 100 }'{
"customerId": "550e8400-e29b-41d4-a716-446655440001",
"developerSpreadFeeBps": 100,
"updatedAt": "2024-01-15T10:30:00.000Z"
}{
"error": "Invalid request data"
}{
"error": "Unauthorized - Invalid or missing API key or session"
}{
"error": "Customers feature is not enabled for your organization"
}{
"error": "Invalid request data"
}Get developer fee balance GET
Returns your organization's current developer fee balance. This balance accumulates from fees charged on customer deposits and can be claimed to your organization's wallet.
Get customer verified address GET
Returns the address on file for a customer. For individual customers, this is extracted from KYC verification data (proof of address). For corporate customers, this is the stored business address. This address is automatically used when creating a first-party withdrawal bank without providing an address.