> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leapfinancial.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Request flow

> Originate a money request so another party can pay via a fund-request link

## Overview

Use **`request`** when your user wants to **ask someone else for money**. The requester opens the magic link, composes the ask (route, amount, payout), and shares a payer-facing link. The payer completes payment on a **`fund-request`** flow.

```mermaid theme={null}
sequenceDiagram
    participant You as Partner API
    participant Req as request flow
    participant Payer as fund-request flow

    You->>Req: POST /partner/links flow=request
    Req->>Req: User builds money request
    Req->>Payer: Shared fund-request URL
    Payer->>Payer: Payer funds and creates operation
```

## Create example

```bash theme={null}
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": "requester_user_123",
    "flow": "request",
    "language": "es",
    "config": {
      "userData": {
        "name": {
          "firstName": "Lucia",
          "lastName": "Mendez"
        }
      },
      "destinationCountry": "MX",
      "destinationCurrency": "MXN"
    }
  }'
```

`config` is optional. Prefilling `userData` (and destination hints) reduces friction for the requester — see [User data](/raas-widgets/guides/user-data).

<Info>
  The payer experience is a separate link with `flow: "fund-request"`. Partners sometimes mint that link themselves when the request payload is already known — see [Fund request](/raas-widgets/flows/fund-request).
</Info>

## Lifecycle and webhooks

After the requester finishes, the platform mints a fund-request link for the sender. When the sender pays, you receive `operation.created` (with `requestId` when applicable) and later a terminal `operation.completed` / `failed` / `cancelled`.

Full journey (including legacy Request API): [Request money lifecycle](/raas-widgets/request-api/lifecycle).

## Next steps

<CardGroup cols={2}>
  <Card title="Fund request" icon="hand-holding-dollar" href="/raas-widgets/flows/fund-request">
    Payer fulfills the ask.
  </Card>

  <Card title="Request money lifecycle" icon="arrows-split-up-and-left" href="/raas-widgets/request-api/lifecycle">
    Ask → fund-request → operation.
  </Card>

  <Card title="Create links" icon="link" href="/raas-widgets/guides/create-links">
    Shared envelope and discriminators.
  </Card>
</CardGroup>