Embed & WebView

Delivery model

RaaS Widgets does not ship a partner SDK for iframe embedding. The integration model is:

Mint a magic link with the Partner API
Deliver data.url to the end user
Let the flow host render the experience

That URL works in a mobile browser, desktop browser, or a native WebView.

Presentation flags

Pass presentation on create-link to tune UI gates before flow-specific screens:

Flag	Default	When to change
`showSplash`	`true`	Set `false` when your app already showed an intro and you want the user dropped into the flow
`showAgreement`	`false`	Set `true` when you need the E-Sign / Terms screen inside the widget

{
  "referenceId": "user-12345",
  "flow": "smart",
  "presentation": {
    "showSplash": false,
    "showAgreement": true
  }
}

Partner theme still loads when splash is disabled.

Native WebView checklist

Mint the link server-side

Never embed your API key in the mobile app. Your backend calls POST /partner/links and returns only the URL (and optionally expiry) to the client.

Load the URL

Open data.url in a full-screen WebView (SFSafariViewController / Chrome Custom Tabs / WKWebView / Android WebView). Prefer system browsers when possible for cookie and biometrics compatibility.

Allow navigation

Keep navigation within the flow host and known CIP/payment domains. Do not intercept or rewrite the path unless Leap documents a callback scheme for your integration.

Handle completion

Prefer webhooks on your backend for authoritative completion. Optionally watch for a partner callbackUrl / redirect if your flow config supports returning to your app.

Deep links and in-app buttons

For non-WebView delivery, open the same url with:

Universal Links / App Links
SMS or email
An in-app “Continue” button that launches the system browser

Security notes

Treat the link URL as a bearer capability until it expires — do not log it in analytics cleartext if avoidable
Revoke links that should no longer be usable (POST /partner/links/{linkId}/revoke)
Use short TTLs for push/SMS channels

Getting Started

Request API

Concepts

Integration

Flows

Webhooks

Operations

Delivery model

Presentation flags

Native WebView checklist

Deep links and in-app buttons

Security notes

Next steps

Create links

Webhooks

​Delivery model

​Presentation flags

​Native WebView checklist

​Deep links and in-app buttons

​Security notes

​Next steps

Create links

Webhooks

Delivery model

Presentation flags

Native WebView checklist

Deep links and in-app buttons

Security notes

Next steps