Cash App Pay is now supported as a tender type for Cash App Afterpay customers using the latest afterpay-button.js file.
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.
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.
To enable Cash App Pay, do the following:
Ensure that you are using the latestafterpay-button.js.
Add a Cash App Pay Button Element.
Identical to the Afterpay Button but with an additional isCashAppPay parameter:
Bind the same order attributes for both Cash App Afterpay and Cash App Pay
a. Managed UI:**
Bind the attributes then call afterpayButton.initializeForCashAppPay.
or
b. Advanced Rendering Controls:**
bind the attributes on the click event or within afterpayButton.renderCashAppPayButton.
onCompleteProcess the credit card using the onComplete callback, which returns the virtual card object and the customer’s cashtag.
Customer Requests may fail due to premature exits or risk-based declines. Use eventListeners to manage state changes on your frontend.
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.
The Cash App customer who approved the request.
Cash App sales support the standard Cash App Afterpay payment reversal process.
Cash App Afterpay handles all payment resolutions, with settlement information available as usual.