Get your setup working faster. Join our Discord for optimisation tips from elite testers.

Test Apple Pay on iOS devices

Learn how to test use cases around Apple Pay on iOS devices with Selenium on BrowserStack Automate

IMPORTANT

This feature is currently a Private Beta service and available only under Desktop and Mobile Pro, and Enterprise Pro plans. Contact our Support team or Sales team to enable this feature. For more details, check out our pricing page.
Setting this feature will lead to an increase in session start-time by 100-180 seconds. Thus, users are expected to use this feature based on their needs.

The Apple Pay feature in iOS devices enables purchases, one-click payments, and provides additional security for financial transactions. BrowserStack Automate enables you to test Apple Pay on remote iOS devices.

This guide covers:

Supported devices
Setting the Apple Pay capability
Using JavaScript executor to confirm the payment
Limitations with Apple Pay

To test Apple Pay on Custom Device Lab, refer to our Testing Apple Pay on Custom Device Lab Automate documentation.

Supported devices

Supported Devices	iOS Version
iPhone 17 Pro	26
iPhone Air	26
iPad Pro 11 2025	26
iPhone 16	18
iPhone 15	17
iPhone 14	16
iPhone 14 Pro	16
iPhone 13 Pro Max	15
iPhone 13 Pro	15
iPhone 13	16
iPhone 13	15

Set the Apple Pay capability

Use the capability values enableApplePay for W3C protocol and browserstack.enableApplePay for JSON wire protocol in your test scripts.

BrowserStack SDK
Non-SDK Integration

If you are using BrowserStack SDK, you can set the following capability within the configuration file:

Capability	Description
`enableApplePay`	Set this capability to `"true"` if you want to use Apple Pay in the test.
`applePayPreferredNetworks`	Set this capability if you want to set preferred payment networks for Apple Pay to improve stability. For example, `["Visa", "Mastercard"]`. This capability is optional.
`nativeWebTap`	Set this capability to `"true"` if you are unable to get Apple Pay payment screen after clicking the Apple Pay button.

BrowserStack uses sandboxed cards provided by Apple for Apple Pay testing. These cards may occasionally fail due to card network instability or limitations.
To improve test stability, you can use the applePayPreferredNetworks capability to specify your preferred payment networks. BrowserStack automatically selects the most stable cards from your preferred networks and adds them to the test session.
This capability is optional, and if not specified, BrowserStack will use a default set of networks.

Set idleTimeout: 300 in browserstack.yml when running Apple Pay tests. Apple Pay setup takes longer than the default idle timeout. Without this setting, BrowserStack ends the session with a BROWSERSTACK_IDLE_TIMEOUT error. The maximum value for Automate is 300.

Example

Copy

Capability	Description
`browserstack.enableApplePay`	Set this capability to `"true"` if you want to use Apple Pay in the test.
`browserstack.applePayPreferredNetworks`	Set this capability if you want to set preferred payment networks for Apple Pay to improve stability. For example, `["Visa", "Mastercard"]`. This capability is optional.
`browserstack.nativeWebTap`	Set this capability to `"true"` if you are unable to get Apple Pay payment screen after clicking the Apple Pay button.

Apple Pay test flow

Your test script must be modified with these custom executors along with the logic to select the UI elements in the webapp that triggers the Apple Pay payment, in the following order.

Trigger the payment workflow that uses Apple Pay as the payment method using your framework-specific commands.

Unable to get Apple Pay payment screen after clicking Apple Pay button?

To resolve this issue, perform any one of the following:

Set the appium:nativeWebTap capability to true.

Or, before you click the Apple Pay button, switch to native context using the following code snippet, and wait for a few seconds for the popup to appear.

await browser.url("https://applepaydemo.apple.com/");
  await browser.waitUntil(
    async () => (await browser.getTitle()).match(/Apple/i),
    15000,
    "Title didn't match"
  );
  await driver.switchContext("NATIVE_APP");
  const button = await $('[name="Apple Pay"]');
  await button.click();

If there are no context switching methods for the language or framework you are using, refer to the following Appium documentation: Set Current Context or The Context API.

Once you complete any one of the above, run the BrowserStack executor for Apple Pay.

If you want to add Apple Pay details such as shipping, billing, or contact information, use the following JavaScript executor with the applePayDetails action.

For the Apple Pay details, ensure the details meet the following conditions:

In your shipping and billing addresses, only include parameters that apply to the addresses and remove the parameters that are not applicable. For example, if your test address doesn’t have a value for the province parameter, remove the parameter from the script.
For the geographical codes in your shipping and billing addresses, use only one of these parameters based on what your address requires and the device accepts: postalCode, postCode, zip. In the following code snippet, we have used postalCode.
The phone number must have the country code prefix with the + character. For example, use this +1-212-456-7890 or +12124567890.

Your session might fail if your test addresses don’t have the fields that the device requires. For example, if your test addresses have the zip parameter, but the device requires a different geographical code parameter, the session will fail. In this case, you can re-run the script with either postalCode or postCode and see which geographical code parameter the device accepts.

driver.executeScript("browserstack_executor: {\"action\":\"applePayDetails\", \"arguments\": {\"shippingDetails\" : {\"firstName\" : \"user input\", \"lastName\" : \"user input\", \"street\" : \"user input\", \"addressLine2\" : \"user input\", \"city\" : \"user input\", \"state\" : \"user input\", \"zip\" : \"user input\", \"province\" : \"user input\", \"islandName\" : \"user input\", \"country\" : \"user input\"}, \"billingDetails\" : {\"firstName\" : \"user input\", \"lastName\" : \"user input\", \"street\" : \"user input\", \"addressLine2\" : \"user input\", \"city\" : \"user input\", \"state\" : \"user input\", \"zip\" : \"user input\", \"province\" : \"user input\", \"islandName\" : \"user input\", \"country\" : \"user input\"}, \"contact\" : {\"email\" : \"user input\", \"phone\" : \"user input\"}}}");

await driver.executeScript("browserstack_executor: {\"action\":\"applePayDetails\", \"arguments\": {\"shippingDetails\" : {\"firstName\" : \"user input\", \"lastName\" : \"user input\", \"street\" : \"user input\", \"addressLine2\" : \"user input\", \"city\" : \"user input\", \"state\" : \"user input\", \"zip\" : \"user input\", \"province\" : \"user input\", \"islandName\" : \"user input\", \"country\" : \"user input\"}, \"billingDetails\" : {\"firstName\" : \"user input\", \"lastName\" : \"user input\", \"street\" : \"user input\", \"addressLine2\" : \"user input\", \"city\" : \"user input\", \"state\" : \"user input\", \"zip\" : \"user input\", \"province\" : \"user input\", \"islandName\" : \"user input\", \"country\" : \"user input\"}, \"contact\" : {\"email\" : \"user input\", \"phone\" : \"user input\"}}}");

((IJavaScriptExecutor)driver).ExecuteScript("browserstack_executor: {\"action\":\"applePayDetails\", \"arguments\": {\"shippingDetails\" : {\"firstName\" : \"user input\", \"lastName\" : \"user input\", \"street\" : \"user input\", \"addressLine2\" : \"user input\", \"city\" : \"user input\", \"state\" : \"user input\", \"zip\" : \"user input\", \"province\" : \"user input\", \"islandName\" : \"user input\", \"country\" : \"user input\"}, \"billingDetails\" : {\"firstName\" : \"user input\", \"lastName\" : \"user input\", \"street\" : \"user input\", \"addressLine2\" : \"user input\", \"city\" : \"user input\", \"state\" : \"user input\", \"zip\" : \"user input\", \"province\" : \"user input\", \"islandName\" : \"user input\", \"country\" : \"user input\"}, \"contact\" : {\"email\" : \"user input\", \"phone\" : \"user input\"}}}");

driver.execute_script("browserstack_executor: {\"action\":\"applePayDetails\", \"arguments\": {\"shippingDetails\" : {\"firstName\" : \"user input\", \"lastName\" : \"user input\", \"street\" : \"user input\", \"addressLine2\" : \"user input\", \"city\" : \"user input\", \"state\" : \"user input\", \"zip\" : \"user input\", \"province\" : \"user input\", \"islandName\" : \"user input\", \"country\" : \"user input\"}, \"billingDetails\" : {\"firstName\" : \"user input\", \"lastName\" : \"user input\", \"street\" : \"user input\", \"addressLine2\" : \"user input\", \"city\" : \"user input\", \"state\" : \"user input\", \"zip\" : \"user input\", \"province\" : \"user input\", \"islandName\" : \"user input\", \"country\" : \"user input\"}, \"contact\" : {\"email\" : \"user input\", \"phone\" : \"user input\"}}}")

driver.execute_script("browserstack_executor: {\"action\":\"applePayDetails\", 
\"arguments\": {\"shippingDetails\" : {\"firstName\" : \"user input\",\"lastName\" : \"user input\",\"street\" : \"user input\",\"addressLine2\" : \"user input\",\"city\" : \"user input\",\"state\" : \"user input\",\"zip\" : \"user input\",\"province\" : \"user input\",\"islandName\" : \"user input\",\"country\" : \"user input\"},\"billingDetails\" : {\"firstName\" : \"user input\",\"lastName\" : \"user input\",\"street\" : \"user input\",\"addressLine2\" : \"user input\",\"city\" : \"user input\",\"state\" : \"user input\",\"zip\" : \"user input\",\"province\" : \"user input\",\"islandName\" : \"user input\",\"country\" : \"user input\"},\"contact\" : {\"email\" : \"user input\",\"phone\" : \"user input\"}}}”)

After initiating the payment flow from your automation, use the following Javascript executor to confirm the transaction.

driver.executeScript("browserstack_executor: {\"action\":\"applePay\", \"arguments\": {\"confirmPayment\" : \"true\"}}");

await driver.executeScript("browserstack_executor: {\"action\":\"applePay\", \"arguments\": { \"confirmPayment\" : \"true\"} }”)

((IJavaScriptExecutor)driver).ExecuteScript("browserstack_executor: {\"action\":\"applePay\", \"arguments\": {\"confirmPayment\" : \"true\"}}");

driver.execute_script("browserstack_executor: {\"action\":\"applePay\", \"arguments\": { \"confirmPayment\" : \"true\"} }”)

driver.execute_script("browserstack_executor: {\"action\":\"applePay\", \"arguments\": { \"confirmPayment\" : \"true\"}}”)

Enter the passcode 123456 to complete the payment.

The following is an example in the Java language:

  driver.getKeyboard().sendKeys("123456");

Example

The following code snippet is an end-to-end example for testing Apple Pay in Ruby language:

require 'rubygems'
require 'selenium-webdriver'

username = "username_name"
access_key = "YOUR_ACCESS_KEY"
url = "https://#{username}:#{access_key}@hub.browserstack.com/wd/hub"

def run_session(bstack_options, url)
 options = Selenium::WebDriver::Options.send "chrome"
 options.browser_name = bstack_options["browserName"].downcase
 options.add_option('bstack:options', bstack_options)
 driver = Selenium::WebDriver.for(:remote,
   :url => url,
   :capabilities => options)
 begin
    driver.navigate.to "https://applepaydemo.apple.com"
    driver.execute_script(
        'browserstack_executor: {
            "action": "applePayDetails",
            "arguments": {
                "billingDetails": {
                    "firstName": "Some",
                    "lastName": "User",
                    "state": "Some State",
                    "city": "Some City",
                    "street": "Some Street",
                    "postCode": "Some Post Code",
                    "country": "Some Country"
                },
                "shippingDetails": {
                    "firstName": "Some",
                    "lastName": "User",
                    "state": "Some State",
                    "city": "Some City",
                    "street": "Some Street",
                    "postCode": "Some Post Code",
                    "country": "Some Country"
                },
                "contact": {
                    "email": "someemail@gmail.com",
                    "phone": "+11234567890"
                }
            }
        }'
    )
 rescue
     driver.execute_script('browserstack_executor: {"action": "setSessionStatus", "arguments": {"status":"failed", "reason": "Some elements failed to load"}}')
 end
 driver.quit
end
BUILD_NAME = "Apple Pay Build"
caps = {
    "deviceName" => "iPhone 15",
    "osVersion" => "17",
    "browserName" => "safari",
    "deviceOrientation" => "portrait",
    "buildName" => BUILD_NAME,
    "enableApplePay" => true,
    "sessionName" => "Apple Pay Test",
    "interactiveDebugging" => true,
    "idleTimeout" => 300
}
run_session(caps, url)

Copy

Limitations with Apple Pay

On BrowserStack remote iOS devices, testing with Apple Pay is limited to the following regions:

Geography	Country
North America	United States, Canada
Europe	France, Ireland, Italy, Spain, United Kingdom, Germany
Asia	China Mainland, Hong Kong, Taiwan, Japan, Russia, Singapore
Australia	Australia, New Zealand

Check this page for a list of various JavaScript Executors that BrowserStack offers.

Did this page help you?

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked

This page has exactly what I am looking for
This content & code samples are accurate and up-to-date
The content on this page is easy to understand
Other (please tell us more below)

Any additional feedback?

Thank you for your valuable feedback

Is this page helping you?

Yes

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked

This page has exactly what I am looking for
This content & code samples are accurate and up-to-date
The content on this page is easy to understand
Other (please tell us more below)

Any additional feedback?

Thank you for your valuable feedback!

Test Apple Pay on iOS devices

Supported devices

Set the Apple Pay capability

Example

Example

Apple Pay test flow

Unable to get Apple Pay payment screen after clicking Apple Pay button?

Example

Limitations with Apple Pay

Related topics

We're sorry to hear that. Please share your feedback so we can do better

We're continuously improving our docs. We'd love to know what you liked

We're sorry to hear that. Please share your feedback so we can do better

We're continuously improving our docs. We'd love to know what you liked