Skip to main content
This requires a verified customer. See the other flows for understanding how to create and verify a new customer.
API_KEY='... your api key ...'
BASE_URL="https://api.sandbox.iron.xyz/api"

# Helper to generate idempotency keys (requires uuidgen installation)
gen_key(){ uuidgen || echo "key-$RANDOM"; }


# Please refer to one of the other flows for generating a
# verified customer
customer_id='...your customer id...'

IDEMPOTENCY_KEY=$(gen_key)
create_resp=$(curl -sSf \
  -X POST "$BASE_URL/addresses/fiat" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $API_KEY" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "customer_id": "'"$customer_id"'",
  "bank_details": {
    "recipient": {
      "type": "Business",
      "name": "Acme Corporation"
    },
    "provider_name": "Deutsche Bank",
    "provider_country": {
      "code": "DE"
    },
    "account_identifier": {
      "type": "SEPA",
      "iban": "DE89370400440532013000"
    },
    "address": {
      "street": "Unter den Linden 77",
      "city": "Berlin",
      "state": "Berlin",
      "country": {
        "code": "DE"
      },
      "postal_code": "10117"
    },
    "email_address": {
      "email": "finance@acmecorp.de"
    },
    "phone_number": "+49 30 1234567",
    "is_third_party": false
  },
  "label": "Primary EUR Business Account",
  "currency": {
    "code": "USD"
  }
}')
echo "$create_resp"

{"success":true}