Skip to main content
Use the Cash App Pay Component to let a customer pay with their Cash App account.
Cash App Pay is available for one-time payments in USD. Pass a billingSessionId to pay() — subscriptions and mandates are not supported.
The component collects nothing from the customer. It is valid as soon as it is mounted, so mounting it and calling pay() with it as payMethod is the whole integration. How the payment completes The flow is chosen automatically from the customer’s device. You do not need to branch on it. Component Options tb_cashApp accepts the same options as qrOptions for UPI QR. On desktop they style the QR payment popup, with higher priority than popupConfig.

Customize Your SDK -> QR payment popup

Learn how to customize the QR payment popup
Returned Value cashApp Cash App Object
Code Snippet for cashApp component

Using your own button

The component renders a transparent button. A common layout is to show your own “Pay with Cash App” tile and keep the component’s iframe out of sight inside it:
For tb_cashApp, the frameStyle you pass to create() also sizes the payment popup. Shrink the component with CSS on its mount node, as shown above, rather than with frameStyle: { width: "1px", height: "1px" }. A 1 px frameStyle makes the popup open at its minimum size (320 × 560 px) and overrides the popup size you set in qrOptions or popupConfig.
On mobile, Cash App opens in a new tab after the payment is created. If the browser blocks that tab, the SDK fires the root error event with code POPUP_BLOCKED and pay() resolves with status: "error". Ask the customer to allow popups for your site and try again.
Next Steps
  • Customize component styles
  • Add multiple payment methods using tabs
  • Handle payment confirmation on backend
  • Set up webhooks for payment status
Need Help? Explore the following sections for more details: If you need assistance, our support team is here to help 🚀