Apple Pay

Apple Pay is a secure, private, hassle-free way to make payments for physical goods and services, as well as donations, within iOS and watchOS apps. Users quickly and easily authorize payments and provide shipping and contact information, using Touch ID and credentials that are securely stored on the device.

Apps indicate when they accept Apple Pay. During checkout, a payment sheet shows the credit or debit card, purchase amount (including tax and fees), shipping options, and contact information. Users make any necessary adjustments and then use Touch ID to authorize payment and complete the purchase.

Websites can also accept Apple Pay. For website-specific design guidance, see Apple Pay on the Web Human Interface Guidelines.

Tip It’s important to understand the difference between Apple Pay and In-App Purchase. Use Apple Pay to sell physical goods such as groceries, clothing, and appliances; for services such as club memberships, hotel reservations, and tickets for events; and for donations. Use In-App Purchase to sell virtual goods, such as premium content for your app, and subscriptions for digital content. See In-App Purchase.

Buttons

The system implements the following button styles for use by apps that accept Apple Pay.

Apple Pay or Buy with Apple Pay button

Apple Pay or Buy with Apple Pay button. Use one of these buttons in your app wherever payment is made, such as on a product detail page or shopping cart page. Tapping this button immediately displays a payment sheet, where users complete the checkout process.

Set Up Apple Pay button

Set up Apple Pay button. Show this button when the device supports Apple Pay, but Apple Pay hasn’t been set up yet. Tapping this button opens the Wallet app and initiates the process of adding a card.

Pay with Apple Pay button

Donate with Apple Pay button. Approved nonprofits can use this button to facilitate donations. On devices running older systems that don't support the Donate with Apple Pay button, display the Apple Pay button instead.BETA

Pay with Apple Pay button

Pay with Apple Pay button. Card issuers can use this button to let people quickly bring up their card in the Wallet app when making a purchase in a physical store.

Styles

All Apple Pay buttons can be displayed using the following styles:

Pay with Apple Pay button

Black. Use on white or light-colored backgrounds that provide sufficient contrast. Don’t use on black or dark backgrounds.

Pay with Apple Pay button

White with outline rule. Use on white or light-colored backgrounds that don’t provide sufficient contrast. Don’t place on dark or saturated backgrounds.

Pay with Apple Pay button

White. Use on dark or colored backgrounds that provide sufficient contrast.

Size and Position

Maintain the minimum width. The minimum width for all Apple Pay buttons is 32pt (32px @1x, 64px @2x).

Maintain minimum clear space. The minimum amount of clear space required around an Apple Pay button is 1/10 of the button's height. Other content, such as graphics and text, should not infringe on this space.

Display the Apple Pay button prominently. Make Apple Pay buttons the same size or larger than other payment buttons. Ideally, scrolling shouldn't be required to see the Apple Pay button.

Position Apple Pay buttons consistently in regard to Add to Cart buttons. Place the Apple Pay button to the right of or above an Add to Cart button.

Apple Pay Mark

A line of credit card logos containing the Apple Pay mark

Use the Apple Pay mark graphic to communicate that Apple Pay is an available payment option when showing other payment options in a similar manner. Download the Apple Pay mark graphic and its usage guidelines here.

Referring to Apple Pay in Text

You can use plain text to promote Apple Pay and indicate that Apple Pay is a payment option.

Capitalize Apple Pay in text as it appears on the Apple Trademark list. Use two words with an uppercase A, an uppercase P, and lowercase for all other letters. Display Apple Pay entirely in uppercase only when doing so is necessary for conforming to an established typographic interface style, such as if your app capitalizes all text. See Apple Trademark List.

Never use the Apple logo to represent the name Apple in text. In the United States, use the registered trademark symbol (®) the first time Apple Pay appears in body text. Do not include a registered trademark symbol when Apple Pay appears as a selection option during checkout.

Coordinate the font face and size with your app. Don't mimic Apple typography. Instead, use text attributes that are consistent with the rest of your app.

Don't translate Apple Pay. Always use Apple trademarks in English, even when they appear within non-English text.

When promoting your app's use of Apple Pay, refer to the App Store Marketing Guidelines.

Presenting Apple Pay as a Payment Option

Offer Apple Pay on all devices that support it. If the device supports Apple Pay but Apple Pay hasn't been set up yet, present the Set up Apple Pay button. If the device doesn’t support Apple Pay, don’t offer Apple Pay as a payment option.

Use only the Apple-provided API to display Apple Pay buttons. Unlike a button graphic, the buttons produced by the API always have the correct appearance and are localized automatically.

Don’t disable or hide an Apple Pay button. If an Apple Pay button can’t be used yet, such as when a product size or color hasn’t been selected, gracefully point out the problem after the button is tapped.

Use the Apple Pay mark only to communicate that Apple Pay is accepted. The mark doesn’t facilitate payment. Never use it as a payment button or position it as a button.

For implementation details, see Apple Pay Programming Guide.

Streamline the Checkout Process

People appreciate using Apple Pay to make purchases quickly and easily. The payment sheet should let them promptly authorize payment and complete the transaction.

Make Apple Pay the default payment option when possible. If Apple Pay is enabled, assume the person wants to use it. Consider presenting the Apple Pay button as the first or only payment option, displaying it larger than other options, or using a line to visually separate it from other choices.

Accelerate single-item purchases with Apple Pay buttons on product detail pages. In addition to offering a shopping cart, consider putting Apple Pay buttons on product detail pages so users can quickly purchase an individual item. Purchases initiated in this way should be for an individual item only, and should exclude any items that already reside in the user's shopping cart. If the user's shopping cart contains an item purchased directly from a product detail page, remove the item from the cart after the purchase is complete.

Accelerate multi-item purchases with express checkout. Consider providing an express checkout feature that immediately displays the payment sheet, allowing users to quickly purchase multiple items using a single shipping speed and destination.

Don't interrupt checkout after the Apple Pay button is tapped. Gather the information you need before people reach the Apple Pay button. When a user taps the Apple Pay button, they should immediately see the payment sheet. Displaying alerts or views that force people to take additional steps after deciding to complete their purchase adds friction and frustration to the process. For example, let people choose options, such as color and size, on a product detail page. On a checkout page, use highlighting or an alert to identify missing information before showing the payment sheet.

Collect optional information before checkout begins. There’s no way to input data on the payment sheet, so collect any optional information such as promo codes, redemption codes, gift messages, and delivery instructions ahead of time.

Gather multiple shipping speeds and destinations before showing the payment sheet. The payment sheet lets people select a single shipping speed and destination for an entire order. If your customers can choose different shipping speeds and destinations for individual items in an order, collect those details before Apple Pay checkout begins.

Prefer information from Apple Pay. Assume that Apple Pay information is complete and up to date. Even if your app has existing contact, shipping, and payment information, consider fetching the latest from Apple Pay during checkout to reduce potential corrections.

Display an order confirmation or thank-you page. After checkout, use an order confirmation page to provide details about when the order will ship and how to check its status. Listing Apple Pay on the confirmation page isn’t necessary, but if you do list it, show it after the last four digits of the account used to process the transaction or as a separate note. For example: "1234 (Apple Pay)" or "Paid with Apple Pay."

Don't require account creation prior to purchase. If you want people to register for an account, ask them to do so on the order confirmation or thank you page. Prepopulate as many registration fields as possible using information provided by the payment sheet during checkout.

Customize the Payment Sheet

You can customize the contents of the payment sheet depending on the information needed to complete the transaction.

Only present and request essential information. People may get confused or concerned if the payment sheet includes extraneous information. For example, it makes sense to see a contact email address but not a shipping address if the purchase, such as a gift card, will be delivered electronically. Showing or asking for a shipping address in this scenario may give the false impression that something will be physically delivered.

Let people choose the shipping method in the payment sheet. To the extent space permits, show a clear description, a cost, and, optionally, an estimated delivery date for each available option.

Keep line items short. Make line items specific and easily understandable at a glance. Whenever possible, they should fit on a single line.

Use line items to explain additional charges, discounts, and pending costs. A line item includes a label and cost. Don’t use line items to show an itemized list of products that make up the purchase.

Provide a business name after the word PAY on the same line as the total. Use the same business name people will see when they look for the charge on their bank or credit card statement. This provides reassurance that payment is going to the right place. If your app acts as an intermediary and is not the end merchant for a payment, clearly indicate this in the following format: PAY [END_MERCHANT_NAME] (VIA [YOUR_APP_NAME]).

Clearly disclose when additional costs may be incurred after payment authorization. In some apps, the total cost may be unknown at checkout time. For example, the price of a car ride based on distance or time might change after checkout. Or, a customer might want to add a tip after a product has been delivered. In situations like these, provide a clear explanation in the payment sheet and a subtotal marked as "AMOUNT PENDING." If you are preauthorizing a specific amount, also make sure the payment sheet accurately reflects this information.

Handle payment errors gracefully. If an error occurs during checkout, dismiss the payment sheet and display an alert or screen that explains the problem and offers advice for resolving it. For related guidance, see Alerts.

Supporting Subscriptions

Your app can use Apple Pay to request authorization for a recurring fee. This may be a fixed amount such as a monthly movie ticket subscription, or a variable amount such as a weekly produce order. The initial authorization can also include discounts and additional fees.

Clarify subscription details before showing the payment sheet. Before asking the user to authorize a recurring payment, make sure they fully understand the billing frequency and any other terms of service.

Include line items that reiterate billing frequency, discounts, and additional upfront fees. Use these line items to remind the user what they're authorizing.

Clarify the current payment amount in the total line. Make sure the user knows what they're being billed at the time of authorization.

Only show the payment sheet when a subscription change results in additional fees. When the user changes their subscription, authorization isn't necessary if the cost decreases or remains the same.

Accepting Donations

Approved nonprofits can use Apple Pay to accept donations.BETA

Use a line item to denote a donation. Display a line item on the payment sheet that reminds users they're authorizing a donation. For example: DONATION $50.00.

Streamline checkout by offering predefined donation amounts. You can reduce steps in the donation process by offering one-tap recommended donations, such as $25, $50, $100. Be sure to include an Other Amount option too, so users can customize the donation if they prefer.