Create a Stripe onboarding link

post/payment/stripe/v1/tenants/{tenant_id}/account/onboarding-link
Requires an API key

Signed-in tenant-admin or Ivora staff; API keys are refused. The return page is server-selected by portal. A pinned account gets a new link for the same account; a tenant without one gets a new Standard account. A tenant whose legacy records already name an account gets payment_account_requires_staff_pin. Links are single-use: an identical retry returns a fresh link.

Path parameters

  • tenant_idintegerRequired

Headers

  • idempotency-keystringRequired

Request body (optional)

  • portalenum
    Where Stripe returns the host: analytics is the Platform's /host page; host is a retired alias for the same page, accepted only where the environment still allows it.
    One of analytics, host · Default "analytics"

Returns · 200

  • urlstringRequired
    Single-use Stripe onboarding link; open it now.
  • stripe_account_idstring | null
POST /payment/stripe/v1/tenants/{tenant_id}/account/onboarding-link
curl --fail-with-body -X POST "https://api.ivoracharge.com/payment/stripe/v1/tenants/1042/account/onboarding-link" \
  -H "Authorization: Bearer $IVORA_API_KEY" \
  -H "Idempotency-Key: order-2026-09-30-0001" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
{
  "url": "https://app.example.com/ivora/webhooks",
  "stripe_account_id": "stripe_account_0123456789abcdef"
}
Try it is not available here yetRequests from this page are off until the production API at https://api.ivoracharge.com is public. Use the code samples from your application server; Ivora grants production access. Keys are created in Developer tools.