Getting Started
Cash App Pay is now supported as a tender type for Cash App Afterpay customers using the latest afterpay-button.js file.
Note
Cash App Pay is currently only available in the United States. If you are an Australian, Canadian, or United Kingdom merchant, ignore this Cash App Pay section of the guide.
Differences Between Cash App Pay and Cash App Afterpay
It is important to understand the distinction between Cash App Pay and Cash App Afterpay.
Key Differences:
-
Cash App Pay allows customers to pay in a single transaction
-
Cash App Afterpay enables customers split payments into installments
Cash App Pay
A digital payment feature that allows customers to make secure, contactless payments in stores or online from their Cash App balance or linked bank accounts.
Cash App Afterpay
A buy now, pay later service available to US merchants only, allowing customers to split payments into four interest-free installments every six weeks.
Implement Cash App Pay
To enable Cash App Pay, do the following:
-
Ensure that you are using the latest
afterpay-button.js. -
Add a Cash App Pay Button Element.
Identical to the Afterpay Button but with an additional
isCashAppPayparameter: -
Bind the same order attributes for both Cash App Afterpay and Cash App Pay
a. Managed UI:**
Bind the attributes then callafterpayButton.initializeForCashAppPay.or
b. Advanced Rendering Controls:**
bind the attributes on the click event or withinafterpayButton.renderCashAppPayButton.
Process the Credit Card using onComplete
Process the credit card using the onComplete callback, which returns the virtual card object and the customer’s cashtag.
Handling Customer Request Changes
Customer Requests may fail due to premature exits or risk-based declines. Use eventListeners to manage state changes on your frontend.
Note
If a request fails or is declined, dispay an error message such as: Could not link Cash App Pay. Please try again or choose a different payment method.
Event Listener Parameters
Customer Interaction Data
CustomerRequestData
Customer
The Cash App customer who approved the request.
Grants
Payment reversals with Cash App
Cash App sales support the standard Cash App Afterpay payment reversal process.
Settlement with Cash App
Cash App Afterpay handles all payment resolutions, with settlement information available as usual.