> ## 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.

# Cash deposit flow

> Mint cash-deposit magic links for merchant cash funding with required config

## Overview

**`cash-deposit`** lets an end user fund via **cash at a physical merchant**. The widget guides deposit instructions and returns the user to your app via a redirect URL.

`config` is **required** and includes at least:

| Field         | Description                                                                 |
| ------------- | --------------------------------------------------------------------------- |
| `callbackUrl` | HTTPS URL to return the user to your host app                               |
| `type`        | `standalone` or `operation_payment`                                         |
| Context       | Sender/recipient for `standalone`, or `operationId` for `operation_payment` |

Optional: `allowedMerchants` allow-list. Full schema: OpenAPI `CreateCashDepositLinkDto`.

## Create example (standalone)

```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": "user_12345",
    "flow": "cash-deposit",
    "config": {
      "callbackUrl": "https://app.example.com/cash-deposit/done",
      "type": "standalone",
      "referenceId": "cd-tx-12345",
      "amount": 500,
      "currency": "USD",
      "senderReferenceId": "sender-9981",
      "sender": {
        "firstName": "Juan",
        "lastName": "Perez",
        "dob": "1990-05-15"
      },
      "recipientReferenceId": "recipient-7742",
      "recipient": {
        "firstName": "Maria",
        "lastName": "Lopez",
        "dob": "1988-03-20"
      }
    }
  }'
```

<Info>
  Confirm field requirements against sandbox OpenAPI — party and amount fields depend on `type` and your enabled corridors.
</Info>

## Next steps

<CardGroup cols={2}>
  <Card title="Create links" icon="link" href="/raas-widgets/guides/create-links">
    Shared create envelope.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/raas-widgets/webhooks/overview">
    Listen for operation lifecycle events.
  </Card>
</CardGroup>