---
description: Learn what Apple Pay STATUS_FAILURE means, why authorization fails, and how merchants can use underlying processor codes to recover declined payments.
title: Apple Pay STATUS_FAILURE: Authorization Failure Explained
image: https://cdn.smartretry.com/_next/static/media/og-image.0z0q4_5kazzzo.jpeg
---

[Skip to main content](#main-content)

Apple Pay · Status

# Apple Pay Status STATUS\_FAILURE: Failure

The payment authorization failed for an unspecified reason (e.g., gateway rejection, processor error). The Apple Pay sheet is dismissed and the customer is prompted to try another method. Processor decline reasons are not surfaced here.

## What it means

The STATUS\_FAILURE code (often implemented natively as PKPaymentAuthorizationStatus.failure) is a generic status indicating that a payment authorization was declined or failed by the merchant's payment processor. It is an abstraction layer response used to dismiss the Apple Pay sheet when an error occurs, and it does not reveal specific network or issuer decline reasons. Apple Pay itself does not reject the transaction here; rather, it reflects a failure returned by the underlying gateway or acquiring bank.

## Classification & retryability

softhardRetryable: conditional

Because this status masks the true decline reason, retry logic must be based on the underlying acquirer or gateway response code rather than the Apple Pay status itself.

## Common causes

* The issuing bank declined the transaction due to insufficient funds, card restrictions, or suspected fraud.
* The payment gateway rejected the authorization due to a misconfiguration, API timeout, or transient outage.
* The merchant's internal fraud filters blocked the transaction based on risk scoring.
* An internal backend error prevented the merchant server from successfully processing the token payload.

## How to resolve it

To resolve a STATUS\_FAILURE, you must investigate the corresponding transaction logs in your payment gateway or acquirer dashboard. The underlying ISO 8583 or processor-specific response code will dictate the proper resolution. If the failure was due to a transient gateway issue or integration bug, correct the technical error and allow the customer to try again. If the underlying cause was a hard issuer decline, the customer must be prompted to use an alternative payment method.

### For merchants

Do not treat STATUS\_FAILURE as a standalone reason code for retry logic. Instead, map your acquirer and PSP response codes to your Apple Pay integration logs to identify the true cause of the failure. When resolving user input errors (such as an invalid billing address), pass specific Apple Pay error objects (e.g., paymentBillingAddressInvalidError) alongside the failure status to guide the customer before the payment sheet dismisses.

### For customers

If the payment fails, verify your billing and shipping details in Apple Wallet. If the issue persists, select a different card to complete the purchase or contact your card issuer to check for account restrictions.

## Sources

* [Apple Developer Documentation – PKPaymentAuthorizationStatus Enum (PassKit)](https://learn.microsoft.com/en-ie/dotnet/api/passkit.pkpaymentauthorizationstatus)
* [Apple Developer Documentation – Apple Pay Overview and PKPaymentAuthorizationResult](https://developer.apple.com/documentation/passkit/apple-pay)
* [Apple Support – If your payment method is declined](https://support.apple.com/en-us/108095)

---

```json
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://www.smartretry.com/"},{"@type":"ListItem","position":2,"name":"Decline Code","item":"https://www.smartretry.com/decline-code"},{"@type":"ListItem","position":3,"name":"Apple Pay","item":"https://www.smartretry.com/payment-providers/apple-pay"},{"@type":"ListItem","position":4,"name":"STATUS_FAILURE","item":"https://www.smartretry.com/decline-code/apple-pay-status-status-failure"}]}
```