Example

End-to-end Cash App deposit with client.cashApp: pick a destination asset, create an order, show checkout, wait for completion.

Session must be loaded and active before createOrder. After a completed payment, call restartSession() before starting again.

1. Set up the client

import {
  createSwappedConnectClient,
  IntegrationProvider,
  Network,
  TokenSymbol,
} from '@swapped/connect-sdk'

const client = createSwappedConnectClient({
  sessionId: 'your-session-id', // from your backend
})

await client.loadSession()

2. Confirm Cash App is available

Filter payment methods by provider. Cash App is not in the exchanges category.

const method = await client.paymentMethods.getOne({
  provider: IntegrationProvider.CashApp,
})

if (!method) {
  throw new Error('Cash App is not available')
}

3. Load assets and validate amount

Use minAmountFiat for the amount field. Pass asset + chain into createOrder (enums, not raw strings).

const assets = await client.cashApp.getSupportedAssets()

const asset = assets.find(
  item => item.asset === TokenSymbol.USDT && item.chain === Network.Ethereum,
)

if (!asset) {
  throw new Error('Selected asset is not available')
}

const amountFiat = '25.00' // USD string from your form

if (Number(amountFiat) < asset.minAmountFiat) {
  throw new Error(`Minimum is $${asset.minAmountFiat}`)
}

4. Create the order

Creating a new order replaces any previous active order.

const order = await client.cashApp.createOrder({
  amountFiat,
  destinationAsset: asset.asset,
  destinationChain: asset.chain,
})

// order.id, order.expiresAt, order.cashAppUrl, order.invoice

5. Show checkout (Cash App / Lightning)

Encode cashAppUrl as a Cash App QR (or open it as a link). Encode invoice as a Lightning QR. Use shortUrl as a compact share/open link.

const { cashAppUrl, shortUrl, invoice } = order

// Encode cashAppUrl as a QR, or:
// <a href={cashAppUrl}>Open Cash App</a>

if (shortUrl) {
  // Compact link - same destination as cashAppUrl
}

// Encode invoice as a Lightning QR

6. Wait for completion, failure, or expiry

const offCompleted = client.cashApp.onOrderCompleted(() => {
  const summary = client.cashApp.getCompletedTransactionSummary()
  console.log(summary)
  // Show success UI, then restart before another payment
  // await client.restartSession()
})

const offFailed = client.cashApp.onOrderFailed(() => {
  // Payment failed - send the user back to the amount form
})

const offExpired = client.cashApp.onOrderExpired(() => {
  // Active order cleared - send the user back to the amount form
})

// Optional: drop a leftover order without waiting for expiry
// client.cashApp.reset()

// Optional: drive a countdown from expiresAt
const expiresAt = client.cashApp.getActiveOrderExpiresAt()

// When leaving the page / tearing down:
// offCompleted(); offFailed(); offExpired();

Full walkthrough

Minimal script that runs the happy path (replace UI prompts with your own form).

import {
  createSwappedConnectClient,
  IntegrationProvider,
  Network,
  TokenSymbol,
} from '@swapped/connect-sdk'

const client = createSwappedConnectClient({ sessionId: 'your-session-id' })
await client.loadSession()

const method = await client.paymentMethods.getOne({
  provider: IntegrationProvider.CashApp,
})
if (!method) {
  throw new Error('Cash App not available')
}

const assets = await client.cashApp.getSupportedAssets()
const asset = assets.find(
  item => item.asset === TokenSymbol.USDT && item.chain === Network.Ethereum,
)
if (!asset) throw new Error('USDT on Ethereum unavailable')

const order = await client.cashApp.createOrder({
  amountFiat: '25.00',
  destinationAsset: asset.asset,
  destinationChain: asset.chain,
})

// Render order.cashAppUrl / order.invoice / order.shortUrl in your UI

client.cashApp.onOrderCompleted(async () => {
  const summary = client.cashApp.getCompletedTransactionSummary()
  console.log('paid', summary)
  await client.restartSession()
})

client.cashApp.onOrderFailed(() => {
  console.log('payment failed - create a new order')
})

client.cashApp.onOrderExpired(() => {
  console.log('order expired - create a new one')
})

Next

Topic	Docs
Asset fields & mins	Assets
Checkout fields / status	Orders & checkout
Countdown helpers	Expiry
Success screen data	Summary
Lifecycle listeners	Events
Error codes	Errors