Apple Pay
Set up your Apple Pay checkout buttons and experience.

Once you’ve successfully set up the Bolt iOS SDK and payment methods, you can customize your Apple Pay checkout button with a few quick lines of code.

1. Enable the Apple Pay Button

Click to expand.

2. Configure Apple Pay Callbacks

Click to expand.

Apple Pay Responses

Depending on the response to the request, there are a few different statuses - coupled with reasons - that may be returned to onApplePayComplete.


The succeeded response will return the reason value of none.


The declined response may have several different provided reason values:

Reason What it means
invalid_amount The amount of the purchase is invalid.
invalid_cvv The provided credit card’s CVV number is invalid.
invalid_cc_number The provided credit card number is invalid.
expired The provided credit card has expired.
risk The transaction appears suspicious and has triggered a risk flag.
lost_stolen The provided credit card was reported lost or stolen.
invalid_merchant_for_card The merchant does not accept the card type provided.
call_issuer There is some undetermined cause for an error - contact the issuer.


Should you receive an error response, rather than one of the declined responses listed above, please reach out to your CSM.

Next Steps

Now that you’re set up with Apple Pay, you can move on to customizing the shopper’s checkout experience or the setting up the Bolt Button.

Filter by Section
Filter by Topic