Apple Pay

Cards

Apple Pay is a digital wallet that lets customers pay using cards stored on Apple devices in apps, online, and in-store.

Struggling with your approval ratio for this payment provider?

contact SmartRetry team →

Published: January 21, 2026
Last updated: May 5, 2026

2 min

Proceed payment with

About Apple Pay

Product Type

Payment Method

Foundation

2014

Stock ID

NASDAQ:AAPL

Company Type

public

Employees

160,000+

Location

USA

Channel

OnlineIn person

For developers

Status page Stack Overflow

Features

Merchant acceptance across channels

Supports in-app, web, and contactless in-store payments where Apple Pay is enabled. Acceptance is determined by your PSP/gateway and acquiring setup.

Authorization and processing compatibility

Uses the underlying card rails (e.g., Visa, Mastercard, Amex) linked to the customer’s wallet. Works with most modern payment stacks that support Apple Pay.

Approval rates and declines visibility

Apple Pay outcomes still depend on issuer authorization and your acquirer/PSP routing. Track Apple Pay declines separately to compare performance vs standard card entry.

Authentication and risk signals

Device-based authentication (e.g., biometric/passcode) can support smoother checkout for returning users. Confirm your PSP’s support for relevant authentication and exemptions.

Security and data handling

Designed to reduce exposure of raw card details at checkout compared to manual entry. Align token/data fields with your fraud tools and reporting.

Disputes and chargebacks

Chargebacks follow the underlying card network rules and are typically managed via your acquirer/PSP. Ensure your descriptor, receipts, and fulfillment evidence are consistent.

Reliability and customer experience

Optimized for quick checkout on Apple devices, which can reduce input errors. Maintain fallback payment methods for customers without Apple Pay enabled.

Tip from SmartRetry If Apple Pay declines are higher than expected, review issuer decline codes and compare routing/acquirer performance for Apple Pay vs manual card entry before changing checkout UX.

Currencies

Processing currenciesUSD, EUR, GBP, JPY, CAD, AUD, CHF, SEK, NOK, DKK, PLN, CZK, HUF, RON, BGN, HRK, RUB, TRY, AED, SAR, INR, SGD, HKD, IDR, MYR, THB, KRW, TWD, PHP, ZAR, BRL, MXN, CLP, COP, PEN, ARS

Available in

Available countries

Egypt
Mauritius
Morocco
South Africa
Australia
China
Hong Kong
Japan
Macau
Malaysia
Mongolia
New Zealand
Singapore
South Korea
Taiwan
Vietnam
Albania
Andorra
Armenia
Austria
Azerbaijan
Belarus
Belgium
Bosnia and Herzegovina
Bulgaria
Croatia
Cyprus
Czechia
Denmark
Estonia
Faroe Islands
Finland
France
Georgia
Germany
Greece
Greenland
Guernsey
Hungary
Iceland
Ireland
Isle of Man
Italy
Kazakhstan
Jersey
Latvia
Liechtenstein
Lithuania
Luxembourg
Malta
Moldova
Monaco
Montenegro
Netherlands
North Macedonia
Norway
Poland
Portugal
Romania
San Marino
Serbia
Slovakia
Slovenia
Spain
Sweden
Switzerland
Ukraine
United Kingdom
Argentina
Bahamas
Brazil
Chile
Colombia
Costa Rica
Dominican Republic
Ecuador
El Salvador
Guatemala
Honduras
Mexico
Panama
Paraguay
Peru
Uruguay
Bahrain
Israel
Jordan
Kuwait
Oman
Palestine
Qatar
Saudi Arabia
United Arab Emirates
Canada
United States

FAQ

Statuses

Statuses — All
Code	Description	Level	Frequency	Resolution
Status
STATUS_SUCCESS	Success The payment was successfully authorized. Pass STATUS_SUCCESS to completePayment to dismiss the Apple Pay sheet with a success animation and proceed with order fulfillment.	Approved	Common	T0
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.	Error, Declined	Common	T2
STATUS_INVALID_BILLING_POSTAL_ADDRESS	Invalid Billing Postal Address The billing postal address provided by the customer is invalid for this merchant. The payment sheet remains open so the customer can correct their billing address. Deprecated in Apple Pay JS v3 (use ApplePayError instead).	Error	Occasional	T0
STATUS_INVALID_SHIPPING_POSTAL_ADDRESS	Invalid Shipping Postal Address The shipping postal address is invalid or unserviceable (e.g., PO boxes not allowed, unsupported country). The payment sheet remains open so the customer can update their address. Deprecated in Apple Pay JS v3.	Error	Occasional	T0
STATUS_INVALID_SHIPPING_CONTACT	Invalid Shipping Contact The shipping contact information (e.g., phone number, email) provided is invalid. The payment sheet stays open for correction. Deprecated in Apple Pay JS v3.	Error	Occasional	T0
STATUS_PIN_REQUIRED	PIN Required The payment requires a PIN to be entered by the cardholder (China UnionPay).	Processing	Occasional	T0
STATUS_PIN_INCORRECT	PIN Incorrect The PIN entered by the cardholder is incorrect (China UnionPay). The customer must re-enter the correct PIN to proceed.	Error, Declined	Occasional	T0
STATUS_PIN_LOCKOUT	PIN Lockout The cardholder has exceeded the allowed PIN attempts and the card is locked (China UnionPay). The customer must contact their bank to unlock the card.	Declined, Error	Rare	T2
Apple Pay Error Code
shippingContactInvalid	Shipping Contact Invalid A field in the shipping contact is invalid (e.g., phone number, email, or name). Used in Apple Pay JS v3+ completeShippingContactSelection and completePayment to indicate which contact field is invalid.	Error	Occasional	T0
billingContactInvalid	Billing Contact Invalid A field in the billing contact is invalid (e.g., incorrect billing name, postal address field). Used in completePayment with ApplePayError to surface specific billing field errors on the payment sheet.	Error	Occasional	T0
addressUnserviceable	Address Unserviceable The shipping address is valid but cannot be serviced by the merchant (e.g., merchant does not ship to this country or region). The payment sheet prompts the customer to choose a different address.	Error	Occasional	T0
couponCodeInvalid	Coupon Code Invalid The coupon code entered on the Apple Pay sheet is not valid. Used in completeCouponCodeChange to indicate the coupon code is unrecognized or incorrectly formatted.	Error	Occasional	T0
couponCodeExpired	Coupon Code Expired The coupon code entered on the Apple Pay sheet has expired and can no longer be applied.	Error	Occasional	T0
unknown	Unknown Error An unknown or unclassified error occurred. Used as a catch-all when the error does not fit a specific category. Log for debugging and prompt the customer to retry.	Error	Occasional	T0