Quick Start

Prerequisites

Before you begin, make sure you have:

A RaaS Widgets partner account (contact sales@leapfinancial.com)
A sandbox API key from the Partner Portal
The smart flow enabled on your partner (allowedFlows)

Use your sandbox API key (raas_sandbox_*) for this guide.

Create your first magic link

The smart flow is the lowest-friction starting point: you only need a referenceId. The end user completes corridor, amount, and payment details inside the widget.

Make the API call

curl -X POST https://raas-widgets-backend-sandbox.up.railway.app/partner/links \
  -H "X-API-Key: raas_sandbox_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "referenceId": "user_12345",
    "flow": "smart",
    "expiresInMinutes": 60
  }'

const response = await fetch(
  'https://raas-widgets-backend-sandbox.up.railway.app/partner/links',
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'raas_sandbox_your_api_key_here',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      referenceId: 'user_12345',
      flow: 'smart',
      expiresInMinutes: 60,
    }),
  },
);

const data = await response.json();
console.log(data.data.url);

import requests

response = requests.post(
    'https://raas-widgets-backend-sandbox.up.railway.app/partner/links',
    headers={
        'X-API-Key': 'raas_sandbox_your_api_key_here',
        'Content-Type': 'application/json',
    },
    json={
        'referenceId': 'user_12345',
        'flow': 'smart',
        'expiresInMinutes': 60,
    },
)

print(response.json()['data']['url'])

Get the response

Response

{
  "success": true,
  "data": {
    "linkId": "link_yourpartner_a1b2c3d4e5f6",
    "referenceId": "user_12345",
    "status": "created",
    "url": "https://<smart-flow-host>/link_yourpartner_a1b2c3d4e5f6",
    "token": "550e8400-e29b-41d4-a716-446655440000",
    "expiresAt": "2026-07-23T15:30:00.000Z",
    "createdAt": "2026-07-23T14:30:00.000Z"
  }
}

You now have a magic link. Deliver data.url to your user.

Send the link to your user

Share the URL through your preferred channel:

Email or SMS
Push notification
In-app button
Native WebView (see Embed & WebView)

Prefer less friction?

Some flows (especially m2m) accept richer config.userData so the widget can skip steps. See User data & friction and the M2M flow guide.

What happens next

User opens the link — the flow widget loads for that linkId
User completes verification — CIP runs when required
User completes the transfer — amount, methods, confirmation
You receive webhooks — link and lifecycle events

Handle webhooks (recommended)

Configure a webhook URL in the Partner Portal. Example event:

Webhook: link.opened

{
  "event": "link.opened",
  "timestamp": "2026-07-23T14:35:00.000Z",
  "data": {
    "linkId": "link_yourpartner_a1b2c3d4e5f6",
    "referenceId": "user_12345",
    "openedAt": "2026-07-23T14:35:00.000Z"
  }
}

Webhooks are signed with HMAC-SHA256 using X-RAAS-* headers. See Webhook Security.

Next steps

Authentication

API keys and security.

Create links

Envelope, flow discriminator, and options.

Flows

Pick the right flow for your product.

Webhooks

Real-time notifications.

Getting Started

Request API

Concepts

Integration

Flows

Webhooks

Operations

Prerequisites

Create your first magic link

Prefer less friction?

What happens next

Handle webhooks (recommended)

Next steps

Authentication

Create links

Flows

Webhooks

​Prerequisites

​Create your first magic link

​Prefer less friction?

​What happens next

​Handle webhooks (recommended)

​Next steps

Authentication

Create links

Flows

Webhooks

Prerequisites

Create your first magic link

Prefer less friction?

What happens next

Handle webhooks (recommended)

Next steps