About the Payment Customization Function API
The Payment Customization API enables you to rename, reorder, and sort the payment methods available to buyers during checkout.
Example use cases
Anchor link to section titled "Example use cases"- Hide payment methods for carts with totals above or below a given value
- Reorder payment methods according to user preference
- Hide payment methods based on customer tag or country
Developer tools and resources
Anchor link to section titled "Developer tools and resources"Migrating from scripts to functions
Anchor link to section titled "Migrating from scripts to functions"If you want to migrate an existing payment script to Shopify Functions, then you can use the following mappings:
Shopify Scripts method | Description | Shopify Functions object | Additional context |
---|---|---|---|
change_name |
Changes the name of a payment option | RenameOperation | |
sort |
Sorts the payment options based on some criteria, typically to place one payment option at the top or bottom of a list | MoveOperation | Instead of sorting, you can move individual payment methods. |
delete_if |
Removes a payment option from checkout | HideOperation |
Limitations and considerations
Anchor link to section titled "Limitations and considerations"- Plan and geographical restrictions apply. Learn more
- When the Payment Customization API usage is restricted, the function input will still contain all payment methods, however output operations that target restricted payment methods will not take effect on the checkout.
The Payment Customization API doesn't currently support draft orders.
You can't rename payment methods that have logos as a name, such as Shop Pay, Apple Pay and Google Pay. This includes all wallets.
You can remove wallets from the Express or payment method section of checkout, but you can't reorder them.
You can install a maximum of five payment customization functions on each store.
- Learn how to use Shopify Functions by building a payment customization.