Smart flow

When to use smart

Use smart when you want the lowest partner create payload and a full in-widget experience for corridor, amount, funding, and payout. It is the recommended starting point for new send integrations.

You need…	Prefer
Minimal create body	`smart`
Rich CIP/payout prefills	`m2m`
Ask someone else to pay	`request`

Ensure smart is in your partner allowedFlows. Discover with GET /partner/flows.

Minimal create

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,
    "language": "es"
  }'

{
  "success": true,
  "data": {
    "linkId": "link_yourpartner_a1b2c3d4e5f6",
    "referenceId": "user_12345",
    "url": "https://<smart-flow-host>/link_yourpartner_a1b2c3d4e5f6",
    "expiresAt": "2026-07-23T15:30:00.000Z"
  }
}

Deliver data.url to your user (SMS, email, or in-app WebView).

Optional envelope fields

You can still pass shared fields such as externalId, metadata, theme, callbackUrl, and presentation — see Create links.

Next steps

Quick start

End-to-end sandbox walkthrough with smart.

Create links

Discriminated union and shared envelope.

Data requests M2M flow

Getting Started

Request API

Concepts

Integration

Flows

Webhooks

Operations

When to use smart

Minimal create

Optional envelope fields

Next steps

Quick start

Create links

​When to use smart

​Minimal create

​Optional envelope fields

​Next steps

Quick start

Create links

When to use smart

Minimal create

Optional envelope fields

Next steps