Skip to main content

Release 2026-09-15

This release adds application-level expiration control for hosted onboarding and change request applications.

Platforms can now set expires_in when creating an application to define how long the hosted flow remains valid, with supported durations from 1 hour up to 90 days.

Application-level expiration with expires_in​

When creating an application, you can now set the expires_in field at the application level to control the application validity window.

The field uses HHHH:mm duration format and supports values from 01:00 (1 hour) to 2160:00 (90 days). If omitted, the default remains 2160:00 (90 days).

POST api.getpaid.io/v2/applications
{
  "type": "onboarding",
  "reference": "53426",
  "expires_in": "336:00",
  "applicant": {
    "email": "markus.keller@garagegermany.de"
  }
}
201 Created - POST api.getpaid.io/v2/applications
{
  "id": "app_4fekhxdpss1et7rjp8t7rdpnw4",
  "status": "initiated",
  "reference": "53426",
  "created_at": "2026-09-15T14:45:22.993Z",
  "updated_at": "2026-09-15T14:45:22.993Z",
  "expires_at": "2026-09-29T14:45:22.993Z",
  "flow": {
    "next_step": {
      "type": "redirect",
      "url": "https://onboarding.getpaid.io/v2/app_4fekhxdpss1et7rjp8t7rdpnw4?token=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIn0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
      "expires_at": "2026-09-29T14:45:22.993Z"
    }
  }
}

This will allow for better control over the expected durations for your sellers to complete their applications.

Application expiration and application_expired webhook​

Applications now expire according to the configured expires_in value.

If an application reaches its expiration time before it is submitted, its status becomes terminally expired and you receive a new application_expired webhook.

application_expired webhook
{
  "id": "evt_49c6zjncp5fk4572vj1y1f9gw8",
  "type": "application_expired",
  "version": "v2",
  "occurred_at": "2026-09-29T14:45:22.993Z",
  "data": {
    "id": "app_4fekhxdpss1et7rjp8t7rdpnw4",
    "reference": "53426"
  }
}

This new status will also reflect on the Getpaid Dashboard, allowing you easily manage expired applications.

See the Applications overview, Onboarding guide, Change requests guide, Create application API reference, and application_expired webhook reference for details.