Skip to content

Payment Customization

The Payment Customization page lets you restrict which payment methods are available at checkout when a gift card is involved. Go to Payments in the left navigation.

This feature uses Shopify's Payment Customization API. It requires the write_payment_customizations scope — if that scope is missing, a warning banner appears with an Update permissions button.

Payment customization settings

Gift Card Payment Rules

Use the rule builder to define conditions under which gift card payment is blocked or restricted. This is useful when you want to prevent gift cards from being used in combination with certain products, customer segments, or order conditions.

  • Click Add rule to create a new condition
  • Each rule can be saved or deleted individually
  • Rules are evaluated at checkout in real time

A link to help documentation is available on this section for guidance on building complex rules.

Restrict Payment Methods

Use this section to hide specific payment methods at checkout when a customer is using a gift card.

The section has two tabs:

For eGift Cards

Select the payment methods to hide when an eGift card is present in the order. A list of your store's available payment methods is shown with checkboxes. Tick a method to hide it when an eGift card is used.

For Physical Gift Cards

The same payment method list, but applied when a physical gift card is involved in the order.

Click Save after making changes in either tab.

Common use cases

Hide "Cash on Delivery" when a gift card is used Some stores don't want cash-on-delivery orders paid partially with gift cards, because reconciling partial cash payments is complex. Restrict COD in the Physical Gift Cards tab.

Prevent gift card + store credit stacking If you have a custom payment method for store credit, you can hide it when a gift card is already applied to prevent double-discounting.

Notes

  • Shopify natively handles gift card validation at checkout — GiftCard Hero's payment customization controls which other payment methods are visible, not the gift card method itself.
  • Changes apply to all future checkouts immediately after saving. No theme changes are needed.