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. This slug is the cash-deposit widget (standalone or operation_payment for an existing operation). A deferred payout that chose CASH_DEPOSIT as funding is still deferred-payout-origination + payout-claim: pay-at-store is launched after the recipient binds, when the operation is awaiting funding. config is required and includes at least:

Field	Description
`callbackUrl`	HTTPS URL the widget uses for Done and host handoff. Wins over the create-link envelope `callbackUrl` while the link is valid. Envelope `callbackUrl` is the fallback live Return to app. Dead links still use Partner Settings `sessionExpiredRedirectUrl`.
`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.

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