public.offramps

Create Offramp

Creates an offramp receive address for the authenticated merchant. Include developer_fee.percentage to keep 0% to 50% of each received deposit; deposit responses and webhooks show the developer fee and customer amount separately from Daya fees. TEMPORARY offramps are only supported with NGN_PAYOUT settlement; INTERNAL_BALANCE settlement requires PERMANENT. Requires an idempotency key in the X-Idempotency-Key header.

post/v1/offramps

Headers

X-Idempotency-Keystring required

Idempotency key for request deduplication

Request body

asset'USDC' | 'USDT' required

type'TEMPORARY' | 'PERMANENT' required

Example request

{
  "asset": "USDC",
  "chain": "BASE",
  "customer": {
    "customer_id": "650e8400-e29b-41d4-a716-446655440000",
    "email": "user@example.com",
    "first_name": "John",
    "last_name": "Doe"
  },
  "developer_fee": {
    "percentage": "1.5"
  },
  "settlement": {
    "destination_bank": {
      "account_name": "Jane Doe",
      "account_number": "0123456789",
      "bank_code": "058"
    },
    "mode": "INTERNAL_BALANCE",
    "rate_id": "550e8400-e29b-41d4-a716-446655440000"
  },
  "type": "PERMANENT"
}

Response

Returned when an existing address is reused

addressstring

assetstring

chainstring

created_atstring

customer_idstring

idstring

statusstring

type'TEMPORARY' | 'PERMANENT'

updated_atstring

Example response

{
  "developer_fee": {
    "percentage": "1.5"
  },
  "settlement": {
    "destination_bank": {
      "account_name": "Jane Doe",
      "account_number": "0123456789",
      "bank_code": "058"
    }
  },
  "type": "PERMANENT"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.