Skip to main content

Stripe Connect onboarding refresh callback

GET 
/company/payment/onboarding/refresh

Callback endpoint to which Stripe redirects when the onboarding link has expired or when the process needs to be resumed with additional information.

Objective​

Update the pending onboarding requirements in the database and display a page with the fields the company must complete.

Use Cases​

  • Expired onboarding link (>5 minutes)
  • Company that interrupted the process and needs to resume it
  • Stripe detects incomplete or incorrect information
  • Display list of pending fields (currently_due, past_due)

Validation Flow​

flowchart TD
  A[Receive Request - account_id] --> B{account_id valid?}
  B -->|No| C[400 STRIPE_ACCOUNT_ID_INVALID]
  B -->|Yes| D[Fetch Stripe account]
  D --> E{Account found?}
  E -->|No| F[404 STRIPE_ACCOUNT_NOT_FOUND]
  E -->|Yes| G{Company found?}
  G -->|No| H[404 CIA_NOT_FOUND]
  G -->|Yes| I[Set status = requirements_needed]
  I --> J[Save to DB]
  J --> K[Render HTML with requirements list]

Notes​

  • No authentication required (it's a public Stripe callback)
  • Always set onboarding_status = 'requirements_needed'
  • To generate a new link: call GET /bank_account_link
  • Include currently_due, past_due, and eventually_due in the template
  • Return HTML, not JSON

Request​

Responses​

HTML page with pending onboarding requirements

Response Headers