Skip to navigation

Embedded flows

Embedded flows let you add customer-facing experiences without rebuilding every screen yourself. Your backend creates or receives a secure URL, your app opens it in a browser or WebView, and AURA returns the customer to your product when the flow is complete.

The same embedding pattern applies to:

Starter project

A minimal React Native (Expo) starter project is available at Aura-app/embed-example-app.

Use it as a reference for opening an AURA-hosted URL, handling navigation inside an embedded browser experience, and returning the customer to your app after the flow completes.

How it works

Your backend creates or receiveshosted URL Your app opens URL Customer completes AURA-hosted flow AURA redirects to your returnURL or closes the active flow Your backend verifies finalstate through the API

Implementation notes

  • Create hosted sessions from your backend, not from an untrusted client.
  • Treat the hosted URL as session-specific and customer-specific.
  • Always verify the final state through the API after a redirect or app return.
  • Handle completed, failed, and cancelled outcomes where a hosted flow provides a returnUrl.
  • For callout tracking, keep the link available while the callout is active so the customer can reopen live tracking.

In the API Reference