# Apple Pay Status Codes Codes used to report the status of an Apple Pay session after a callback. ## Discussion Use an appropriate status code to report your status when you complete a callback. > Note: > Use a status code that is supported for the completion method you are calling. |Method |Supported status codes | |--------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment`` |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/STATUS_SUCCESS``  ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/STATUS_FAILURE``  Use for Apple Pay API version 2 or earlier:  ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/STATUS_INVALID_BILLING_POSTAL_ADDRESS``  ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/STATUS_INVALID_SHIPPING_POSTAL_ADDRESS``  ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/STATUS_INVALID_SHIPPING_CONTACT``  ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/STATUS_PIN_INCORRECT``  ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/STATUS_PIN_LOCKOUT``  ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/STATUS_PIN_REQUIRED``| |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completeShippingContactSelection``|``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/STATUS_SUCCESS``  ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/STATUS_FAILURE``  Use for Apple Pay API version 2 or earlier:  ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/STATUS_INVALID_SHIPPING_POSTAL_ADDRESS`` | |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completeShippingMethodSelection`` |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/STATUS_SUCCESS``  ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/STATUS_FAILURE`` | Apple Pay JS API supports customized errors in Apple Pay API version 3 and later. Use only [`STATUS_SUCCESS`](/documentation/ApplePayontheWeb/ApplePaySession/STATUS_SUCCESS) and [`STATUS_FAILURE`](/documentation/ApplePayontheWeb/ApplePaySession/STATUS_FAILURE) for code using version 3. See [`ApplePayError`](/documentation/ApplePayontheWeb/ApplePayError) for information on custom errors. ## Topics ### Status Code Constants [`STATUS_FAILURE`](/documentation/ApplePayontheWeb/ApplePaySession/STATUS_FAILURE) The requested action failed. [`STATUS_SUCCESS`](/documentation/ApplePayontheWeb/ApplePaySession/STATUS_SUCCESS) The requested action succeeded. [`STATUS_INVALID_BILLING_POSTAL_ADDRESS`](/documentation/ApplePayontheWeb/ApplePaySession/STATUS_INVALID_BILLING_POSTAL_ADDRESS) The billing address is invalid. [`STATUS_INVALID_SHIPPING_POSTAL_ADDRESS`](/documentation/ApplePayontheWeb/ApplePaySession/STATUS_INVALID_SHIPPING_POSTAL_ADDRESS) The shipping address is invalid. [`STATUS_INVALID_SHIPPING_CONTACT`](/documentation/ApplePayontheWeb/ApplePaySession/STATUS_INVALID_SHIPPING_CONTACT) The shipping contact information is invalid. [`STATUS_PIN_INCORRECT`](/documentation/ApplePayontheWeb/ApplePaySession/STATUS_PIN_INCORRECT) The PIN information is not valid. [`STATUS_PIN_LOCKOUT`](/documentation/ApplePayontheWeb/ApplePaySession/STATUS_PIN_LOCKOUT) The maximum number of tries for a PIN has been reached and the user has been locked out. [`STATUS_PIN_REQUIRED`](/documentation/ApplePayontheWeb/ApplePaySession/STATUS_PIN_REQUIRED) The required PIN information was not provided. ## See Also [`supportsVersion`](/documentation/ApplePayontheWeb/ApplePaySession/supportsVersion) Detects whether a web browser supports a particular Apple Pay version. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)