Skip to content
Daviont edited this page Feb 9, 2023 · 1 revision

Welcome to the www.yaml.org wiki!

Stripe Thin Webhook: Connected Accounts

This page describes the configuration and behavior of our Stripe webhook setup for thin payloads, focusing on issuing cardholders and virtual cards for connected accounts.

🔧 Configuration

  • Events from: Connected Accounts
  • Payload Style: Thin
  • API Version: Unversioned
  • Destination Name: viviarentals-cardholders-thin
  • Endpoint URL: https://viviarentals-app.netlify.app/api/stripe-webhook
  • Listening to Events:
    • issuing.cardholder.created
    • issuing.cardholder.updated
    • issuing.card.created

🔄 Webhook Handling

Because we use thin payloads, Stripe sends only the event ID:

{
  "id": "evt_1RRZGbEJivO5BhQbOwylnXy9",
  "object": "event",
  "api_version": "2025-03-31.basil",
  "created": 1747920877,
  "data": {
    "object": {
      "id": "acct_1RDCRGEJivO5BhQb",
      "object": "account",
      "business_profile": {
        "annual_revenue": {
          "amount": 300000000,
          "currency": "usd",
          "fiscal_year_end": "2024-12-31"
        },
        "estimated_worker_count": 10000,
        "mcc": "5734",
        "minority_owned_business_designation": null,
        "name": "VIVIA-CONNECT",
        "support_address": {
          "city": "Scottsdale",
          "country": "US",
          "line1": "14301 North 87th Street",
          "line2": null,
          "postal_code": "85260",
          "state": "AZ"
        },
        "support_email": "[email protected]",
        "support_phone": "+14802157365",
        "support_url": "https://www.viviarentals.com/support",
        "url": "https://www.viviarentals.com"
      },
      "business_type": "company",
      "capabilities": {
        "acss_debit_payments": "active",
        "affirm_payments": "active",
        "afterpay_clearpay_payments": "active",
        "amazon_pay_payments": "active",
        "bancontact_payments": "active",
        "card_issuing": "active",
        "card_payments": "active",
        "cartes_bancaires_payments": "pending",
        "cashapp_payments": "active",
        "eps_payments": "active",
        "klarna_payments": "active",
        "link_payments": "active",
        "p24_payments": "inactive",
        "transfers": "active",
        "us_bank_account_ach_payments": "active"
      },
      "charges_enabled": true,
      "company": {},
      "controller": {
        "type": "account"
      },
      "country": "US",
      "default_currency": "usd",
      "details_submitted": true,
      "email": "[email protected]",
      "future_requirements": {
        "alternatives": [],
        "current_deadline": null,
        "currently_due": [],
        "disabled_reason": null,
        "errors": [],
        "eventually_due": [],
        "past_due": [],
        "pending_verification": []
      },
      "payouts_enabled": true,
      "requirements": {
        "alternatives": [],
        "current_deadline": null,
        "currently_due": [],
        "disabled_reason": null,
        "errors": [],
        "eventually_due": [
          "person_1RDa2iEJivO5BhQbOfKEVOn7.phone"
        ],
        "past_due": [],
        "pending_verification": []
      },
      "settings": {
        "bacs_debit_payments": {
          "display_name": null,
          "service_user_number": null
        },
        "branding": {
          "icon": null,
          "logo": "file_1RJZXbEJivO5BhQbw5gUNW8F",
          "primary_color": "#525f7f",
          "secondary_color": "#0074d4"
        },
        "card_issuing": {
          "tos_acceptance": {
            "date": 1747920874,
            "ip": "181.214.226.245"
          }
        },
        "card_payments": {
          "statement_descriptor_prefix": "VIVIAC",
          "statement_descriptor_prefix_kanji": null,
          "statement_descriptor_prefix_kana": null
        },
        "dashboard": {
          "display_name": "VIVIA CONNECT",
          "timezone": "Etc/UTC"
        },
        "invoices": {
          "default_account_tax_ids": null,
          "hosted_payment_method_save": "always"
        },
        "payments": {
          "statement_descriptor": "VIVIA SIBBACH",
          "statement_descriptor_kana": null,
          "statement_descriptor_kanji": null
        },
        "payouts": {
          "debit_negative_balances": true,
          "schedule": {
            "delay_days": 2,
            "interval": "daily"
          },
          "statement_descriptor": null
        },
        "sepa_debit_payments": {}
      },
      "type": "standard"
    },
    "previous_attributes": {
      "capabilities": {
        "card_issuing": "inactive"
      },
      "requirements": {
        "currently_due": [
          "settings.card_issuing.tos_acceptance.date",
          "settings.card_issuing.tos_acceptance.ip"
        ],
        "eventually_due": [
          "person_1RDa2iEJivO5BhQbOfKEVOn7.phone",
          "settings.card_issuing.tos_acceptance.date",
          "settings.card_issuing.tos_acceptance.ip"
        ],
        "past_due": [
          "settings.card_issuing.tos_acceptance.date",
          "settings.card_issuing.tos_acceptance.ip"
        ],
        "pending_verification": [
          "person_1RDa2iEJivO5BhQbOfKEVOn7.verification.document"
        ]
      },
      "settings": {
        "card_issuing": {
          "tos_acceptance": {
            "date": null,
            "ip": null
          }
        }
      }
    }
  },
  "livemode": false,
  "pending_webhooks": 1,
  "request": {
    "id": "req_DAtAYv6BEDH0bE",
    "idempotency_key": "f74bb7a6-e696-4348-a5e5-55875659cabd"
  },
  "type": "account.updated"
}
Clone this wiki locally