Quick answer: which method should you use?
| Method | Best for | Shopify Plan | Code needed | Setup time |
|---|---|---|---|---|
| Payment customization app | Most merchants | Basic and up | No | 5 minutes |
| Checkout Blocks (native) | Shopify Plus stores wanting native solution | Plus only | No | 10-15 minutes |
| Custom Shopify Function | Stores with developers wanting full control | Any (custom app) | Yes (Rust/JS) | Hours to days |
For most Shopify stores, an app is the right choice. It’s the fastest to set up, works on all plans, and covers hide + rename + reorder in one tool.
What you can customize
Shopify’s Payment Customization Function API supports three actions:
Hide
Remove a payment method from checkout entirely — either always or when specific conditions are met. Examples: hide Klarna for pre-order products, hide PayPal for CBD items, hide bank transfer for retail customers.
Rename
Change the display name of a payment method. Examples: rename “Credit Card” to “Debit Card / Credit Card” (since the field accepts both), rename “Manual Payment” to “Pay by Invoice (Net 30).”
Limitation: You cannot rename payment methods that display with a logo (Klarna, PayPal, Shop Pay, Apple Pay, etc.). Rename only works on text-based methods like Cash on Delivery, Bank Deposit, and manual payment methods.
Reorder
Change the display position of payment methods at checkout. The first method in the list gets the most selections. Examples: move iDEAL to position 1 for Netherlands customers, move Shopify Payments above PayPal to reduce fees.
Method 1: Using a payment customization app
This is the recommended approach for most Shopify merchants.
Step by step
- Install a payment customization app — like Nex Reorder Payment Method from the Shopify App Store
- Choose your action — Hide, Rename, or Reorder
- Select the payment method — enter the exact name as it appears at checkout (e.g., “Klarna,” “PayPal,” “Bank Deposit”)
- Set conditions (optional):
- Country or region
- Customer tag (B2B, VIP, wholesale)
- Product tag, variant, or collection
- Cart total or subtotal
- Discounts in the cart
- Shipping option
- Activate the rule — changes apply immediately at checkout
Conditions explained
Hide by country: Show only relevant payment methods per market. Hide local payment methods for customers outside their country. Hide payment methods that don’t support certain currencies.
Hide by product tag: Tag products that shouldn’t allow certain payment methods. Common tags: no-klarna, no-afterpay, no-bnpl, preorder, restricted.
Hide by customer tag: Create different payment setups for B2B vs retail, VIP vs standard, or flagged vs trusted accounts.
Hide by cart total: Block high-fee payment methods on small orders, or block credit cards on very large orders for fraud prevention.
Apps that handle payment customization
- Nex Reorder Payment Method — hide, rename, reorder for both payment AND shipping methods. $4.99/mo. Built for Shopify.
- HidePay — hide, sort, rename payment methods. Shipping requires separate HideShip app.
- Payfy — hide, sort, rename payment methods. Shipping requires separate Shipzy app.
- Kip — hide, rename, reorder payment methods. No shipping support.
Method 2: Shopify Checkout Blocks (Plus only)
Shopify Plus merchants can use the native Checkout Blocks app.
How to hide a payment method
- Go to your Shopify admin → Apps → Checkout Blocks
- Click Functions → Create function
- In the Payment methods section, click Hide
- Enter a function name (internal only, customers don’t see it)
- In the Type section, select the rule type (conditional or unconditional)
- In Hidden payment methods, click + Add method
- Select the payment method and configure conditions
- Click Save → Set status to Active
How to rename a payment method
- Follow steps 1-2 above
- Click Rename instead of Hide
- Select the payment method in the “From” row
- Configure the new name in the “To” row (replace, add prefix, or add suffix)
- Save and activate
How to reorder payment methods
- Follow steps 1-2 above
- Click Reorder
- Add payment methods and set their order (position 1 = first)
- Manually reordered methods appear first; all others follow
- Save and activate
Checkout Blocks limitations
- Available only on Shopify Plus
- Maximum 25 active payment customizations per store (across all apps)
- Conditional rules work only for hiding — rename and reorder are unconditional
- Cannot rename payment methods with logos
- Wallets can be hidden but not reordered in the express payment section
Method 3: Custom Shopify Function (developer required)
For complete control, build a custom app using the Payment Customization Function API.
Overview
Shopify Functions let you write server-side logic that runs inside Shopify’s infrastructure. A payment customization function receives the checkout cart data as input and returns a list of operations (hide, rename, move) to apply to payment methods.
What you need
- Shopify CLI installed
- A Shopify app (created with Shopify CLI or the Partner Dashboard)
- Node.js 16+ and Rust toolchain (for the function itself)
- A development store for testing
High-level steps
- Generate a function scaffold with
shopify app generate extension - Choose the payment customization template
- Write your function logic in
src/run.rs(Rust) orsrc/run.js(JavaScript) - Define your input query in
input.graphqlto fetch the cart data your function needs - Deploy with
shopify app deploy - Test on your development store
When to use this approach
- You need logic that no app provides (e.g., based on metafields, custom cart attributes, or complex multi-condition rules)
- You’re an agency building for a client and want full control
- You’re already building a custom Shopify app and want payment customization baked in
For most merchants, this is overkill. An app provides the same functionality without the development and maintenance overhead.
Shopify Scripts are deprecated
If you’re still using Shopify Scripts (Payment Scripts via the Script Editor app), you need to migrate. Shopify Scripts were deprecated in August 2025 and are no longer supported.
The replacement is Shopify Functions — which is what powers both third-party apps and Shopify’s native Checkout Blocks.
Common use cases
| Use case | Action | Condition |
|---|---|---|
| Hide Klarna for pre-orders | Hide | Product tag = “preorder” |
| Move iDEAL first for Netherlands | Reorder | Country = NL |
| Hide PayPal to reduce fees | Hide or Reorder | Always apply |
| Hide BNPL for restricted items | Hide | Product tag = “no-bnpl” |
| B2B: bank transfer only | Hide (all except bank transfer) | Customer tag = “B2B” |
| Rename for clarity | Rename | Always apply or Customer tag |
| Hide credit cards on large orders | Hide | Cart total > $2,000 |
| Hide express checkout buttons | Hide | Always apply |
Limitations to know
- 25 active rules per store — Shopify limits payment customization functions to 25 per store across all apps. Most stores use far fewer.
- Can’t rename logos — payment methods with logos (Klarna, PayPal, Shop Pay, Apple Pay, Google Pay) cannot be renamed. Only text-based methods support rename.
- US/Canada credit card limitation — on non-Plus plans in the US and Canada, credit card field customizations don’t apply. Other payment methods work fine.
- No POS support — Payment Customization Functions don’t currently run in Shopify POS.
- Shop Pay limitations — Shop Pay only supports hiding (deactivating) gift cards. Other customizations aren’t compatible with Shop Pay.
Next steps
- Decide your method — app for most merchants, Checkout Blocks for Plus stores wanting native, or custom function for developer-heavy teams
- Start with your highest-impact rule — usually hiding an irrelevant payment method or reordering to prioritize your preferred option
- Test in checkout — place a test order to verify the rules work as expected
- Add more rules — expand to other countries, customer segments, or product categories
Install Nex Reorder Payment Method → | See All Features → | See Pricing →