Fund request flow

Overview

fund-request is the payer side of request money. The link config carries the amount, currencies, and requester/payout profile (requestData) so the payer can quote and fund without re-entering the ask.

Unlike request or smart, config is required for fund-request. Omitting amount / currency / requestData fails validation.

Required config (conceptual)

Field	Role
`amount`	Pinned amount (send or receive, per `amountAnchor`)
`sourceCountry` / `destinationCountry`	ISO 3166-1 alpha-2 corridor
`sourceCurrency` / `destinationCurrency`	ISO 4217 codes
`requestData`	Requester profile + payout method (Request API–shaped)
`amountAnchor`	Optional: `send` (default) or `receive`

Exact property names and nested payout shapes are in OpenAPI (CreateFundRequestLinkDto).

Create example

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": "payer_user_456",
    "flow": "fund-request",
    "expiresInMinutes": 1440,
    "config": {
      "amount": 100,
      "amountAnchor": "send",
      "sourceCountry": "US",
      "destinationCountry": "MX",
      "sourceCurrency": "USD",
      "destinationCurrency": "MXN",
      "requestData": {
        "name": {
          "firstName": "Lucia",
          "lastName": "Mendez"
        },
        "payoutMethod": {
          "type": "bank_account",
          "bankAccount": {
            "country": "MX",
            "accountNumber": "012345678901234567"
          }
        }
      }
    }
  }'

Often the request flow mints this payer link for you after the requester finishes. Use Partner create when you already have a complete ask payload (migration from Request API, server-side orchestration).

After the payer pays

When the sender confirms funding, RaaS Widgets creates an operation. You receive operation.created (often with requestId) and later operation.completed, operation.failed, or operation.cancelled. See Request money lifecycle and Operation lifecycle.

Request

Originate the money request.

Request money lifecycle

Ask → fund-request → operation.

Operations

List transfers after the payer completes.

Getting Started

Request API

Concepts

Integration

Flows

Webhooks

Operations

Overview

Required config (conceptual)

Create example

After the payer pays

Request

Request money lifecycle

Operations

​Overview

​Required config (conceptual)

​Create example

​After the payer pays

​Related

Request

Request money lifecycle

Operations

Overview

Required config (conceptual)

Create example

After the payer pays

Related