Cash App Pay is available for one-time payments in USD. Pass a
billingSessionId to pay() — subscriptions and mandates are not supported.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
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:Popup blockers
On mobile, Cash App opens in a new tab after the payment is created. If the browser blocks that tab, the SDK fires the rooterror event with code POPUP_BLOCKED and pay() resolves with status: "error". Ask the customer to allow popups for your site and try again.
- Customize component styles
- Add multiple payment methods using tabs
- Handle payment confirmation on backend
- Set up webhooks for payment status