Cash deposit flow

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)

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"
      }
    }
  }'

Confirm field requirements against sandbox OpenAPI — party and amount fields depend on type and your enabled corridors.

Next steps

Create links

Shared create envelope.

Webhooks

Listen for operation lifecycle events.

Fund request flow Deferred payout

Getting Started

Request API

Concepts

Integration

Flows

Webhooks

Operations

Overview

Create example (standalone)

Next steps

Create links

Webhooks

​Overview

​Create example (standalone)

​Next steps

Create links

Webhooks

Overview

Create example (standalone)

Next steps