Manage payments app extensions

In this tutorial, you'll learn how to do the following tasks:

• Configure offsite and credit card payments app extensions.
• Submit your payments app extension for review.
• Publish a version of your payments app extension.

• You've applied and been approved to become a Payments Partner.
  • You've created a Partner account and a development store.
• You understand how apps fit into Shopify and the different ways of distributing your app.

• You've created an app that uses Shopify CLI 3.0 or higher, or you've migrated your existing app so that it's compatible with Shopify CLI 3.0 or higher.

• You've disabled the embedded app configuration for your app in the Partner Dashboard.

1. From your Partner Dashboard, click Apps.
2. Click the name of the app that you want to change.
3. Click Extensions.
4. Click Create +.
5. Select the Payments tab to create an offsite payments app extension or credit card payments app extension.
6. Enter your extension name and select Create.

1. From the Extension settings page, click Open draft.

2. Configure the fields of the payments app extension, and then click Save draft.

   • List of configuration fields for an offsite payments app extension.
   • List of configuration fields for a credit card payments app extension.

After you've finished your draft, you can submit your payments app extension for review. You can use this same process to submit new versions of your payments app extension.

1. From the Extension details page, click Create version.

2. Select Minor or Major version.

Minor versions introduce changes that are backwards compatible. Major version changes aren't backwards compatible and might affect users who are currently using your extension.

1. Select Submit for Review.

2. Wait for Shopify to approve your submitted version of your payments app extension. For more information, refer to the payments app approval process.

While Shopify reviews your payments app extension, the version displays a Pending state:

After Shopify approves your payments app extension version, it's marked with Approved and Live tags:

After your payments app extension has been approved, you can publish it.

When you publish your payments app extension, the configuration of your payments app extension that you chose to publish becomes live. After the first payments app extension is published, the payments app extension can be used and tested.

1. Select Publish beside the version that you want to publish.
2. Click Publish in the popup modal to confirm.

Don't unpublish a version of your payments app extension. Instead, you should publish a different version of your payments app extension.

Unpublishing a version of your payments app extension invalidates the payments app provider. It breaks the payments app provider for stores that have it installed because the store tries to fetch a published version that no longer exists.

• Learn how to implement a payments app to process transactions.