For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
GuidesAPI Reference
GuidesAPI Reference
    • Welcome
  • Product Overview
    • How Cash App Pay Works
    • Cash App Pay on Desktop and POS Devices
    • Cash App Pay on Mobile Devices
  • Partnerships
    • Partner with Cash App Pay
    • Partner Onboarding Requirements
    • Merchant Use Policy
    • Program Rules
  • Technical Guides
    • Cash App Pay Integration Basics
      • Payment Flow Operations
      • On-File Payments
      • Incremental Authorization
      • Settlement
      • Refunds
  • Resources
    • Cash App Pay Assets
    • Glossary of Terms
    • Cash App Pay Status
  • Pay Kit SDK
LogoLogo
On this page
  • Refunds
  • Refund Authorization
  • Refund Authorization Failure Scenarios and Error Codes
  • Refund Capture
  • Void a Refund
Technical GuidesPayment Processing

Refunds

Was this page helpful?
Previous

About

Next
Built with

List of topics in this article

  • Refunds

  • Issue a Refund (Authorization)

  • Capture a Refund

  • Void a Refund

Refunds

Refunds allow a Merchant/PSP to send funds from a Merchant to a Customer.

Refunds are linked to a previously captured Cash App Pay Payment. They must not have an amount greater than the captured amount on the original Payment. Read more here

Cash App has set a maximum time limit of 7 years to issue a refund.

Refunds typically process in several business days following initiation, except for Stored Value Balance (SVB) which is immediate. Transaction fees will not be returned to the PSP in the event of a refund.

refunds.png

Refund Authorization

Authorizations are valid for and must be captured within 7 days to complete a Refund. Authorizations not captured within 7 days are voided, and a new authorization will be required to complete a Refund.

Refunds can be authorized and captured via a single API call by setting capture=true. See the API reference for more information.

Refund Authorization Failure Scenarios and Error Codes

ActionDescription
PAYMENT_NOT_FOUND (linked refunds only)Cash App could not find the Payment to Refund.
CUSTOMER_DISABLEDThe Cash App account of the Customer receiving the Refund is deactivated.
MERCHANT_DISABLEDMerchant is deactivated in Cash App Pay and cannot issue Refunds.
MERCHANT_PENDINGMerchant onboarding has not yet completed and the Merchant cannot issue Refunds.
REFUND_DECLINED_COMPLIANCERefund is declined by Block for compliance reasons, including violation of Cash App Terms of Service, Program Rules, or applicable laws.
REFUND_DECLINED_OTHERRefund is declined for an unknown reason.
REFUND_DECLINED_RISKRefund is declined due to riskiness. Block’s risk models will decline Refunds if they detect potentially fraudulent or otherwise risky activity.
REFUND_INVALID_AMOUNT_MISMATCHRefund amount did not match the amount shown to the Customer during the Customer Request for Refund.
REFUND_INVALID_CURRENCY_MISMATCHRefund currency did not match the currency shown to the Customer during the Customer Request for Refund, or the currency of the Merchant did not match the Refund’s currency.
REFUND_INVALID_PAYMENT_UNCAPTUREDThe Payment being refunded has not been captured and therefore cannot be refunded.
REFUND_INVALID_TOO_LARGEThe requested Refund amount is too high. Cash App Pay’s maximum Refund size may be adjusted to prevent fraud, though this is not equivalent to a risk decline (REFUND_DECLINED_RISK).
REFUND_INVALID_TOO_SMALLThe requested Refund amount is too low (below $0.01 USD).

Refund Capture

Once a Refund has been authorized, it must be captured within 7 days to complete the Refund and trigger the Settlement process. Only the exact amount that was authorized is captured since Refunds should not be over or under-captured.

Void a Refund

Once a Refund has been authorized but before it has been captured, it can be voided. This cancels the authorization and is a terminal state for the Refund. This is only applicable while the Refund authorization is valid.

If a Refund is not captured seven days after authorization, it will be automatically voided.