Contents

Button customisation

 

The following information can be used to customise the appearance of the Apple Pay button to better suit the terminology of your checkout experience.

 


 

buttonText

Apple allows you to change the text displayed on the Apple Pay button. To do so, add the buttonText field to your Javascript, and pass through one of the values below* :

 

buttonText Preview Description
plain Apple Pay button The default appearance.
buy Buy with Apple Pay button Alternative design.
donate Donate with Apple Pay button This button is for non-profit organizations to accept donations from within your app and website. Similar to using Apple Pay to buy goods and services, customers can donate without entering their billing, delivery, or contact details.

Important: Those looking to accept donations using Apple Pay are subject to additional requirements.

Click here for further information.

book Book with Apple Pay button For example, a restaurant might use this button to let people book a reservation.
check-out For example, a website offering a shopping cart might use this button to allow their customers to purchase the items in the cart.

Use this button if other payment buttons start with the text Check out for a more consistent user experience.

subscribe Subscribe with Apple Pay button For example, a newspaper or magazine might use this button to allow their customers to initiate a monthly subscription.

* These values are defined by Apple and are subject to change. Click here for further information.

 

The following is an example of how to reference the Apple Pay library (as described here), with additional markup that changes the text displayed on the Apple Pay button:

 


 

buttonStyle

You can also choose from different colour options. To do so, add the buttonStyle field to your Javascript, and pass through one of the values below* :

 

buttonStyle Preview Description
black A black Apple Pay button over a light gray background. Black Apple Pay button
white A white Apple Pay button over a dark green background. White Apple Pay button
white-outline A white, outlined Apple Pay button over a light gray background. White button with a black outline

* These values are defined by Apple and are subject to change. Click here for further information.

 

The following is an example of how to reference the Apple Pay library (as described here), with additional markup that changes the colour of the Apple Pay button:

 


 

Additional resources

External
Apple provides guidelines on how to best position and configure the Apple Pay button.

Click here to learn more.