List of topics in this article

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.

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

Action	Description
PAYMENT_NOT_FOUND (linked refunds only)	Cash App could not find the Payment to Refund.
CUSTOMER_DISABLED	The Cash App account of the Customer receiving the Refund is deactivated.
MERCHANT_DISABLED	Merchant is deactivated in Cash App Pay and cannot issue Refunds.
MERCHANT_PENDING	Merchant onboarding has not yet completed and the Merchant cannot issue Refunds.
REFUND_DECLINED_COMPLIANCE	Refund is declined by Block for compliance reasons, including violation of Cash App Terms of Service, Program Rules, or applicable laws.
REFUND_DECLINED_OTHER	Refund is declined for an unknown reason.
REFUND_DECLINED_RISK	Refund is declined due to riskiness. Block’s risk models will decline Refunds if they detect potentially fraudulent or otherwise risky activity.
REFUND_INVALID_AMOUNT_MISMATCH	Refund amount did not match the amount shown to the Customer during the Customer Request for Refund.
REFUND_INVALID_CURRENCY_MISMATCH	Refund 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_UNCAPTURED	The Payment being refunded has not been captured and therefore cannot be refunded.
REFUND_INVALID_TOO_LARGE	The 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_SMALL	The 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.