# Payment customization apps: rename, reorder, and hide payment methods

PAYMENT CUSTOMIZATION APPS: RENAME, REORDER, AND HIDE PAYMENT METHODS

Some apps in the LaunchMyStore marketplace use payment customizations to reshape
the payment-method list shoppers see at checkout. This article explains what to
expect when you install one.


WHAT IT DOES

A payment customization app modifies your payment-method list at the moment it's
about to be shown to the shopper. The app can:

 * Hide a payment method for specific carts or destinations — for example, hide
   cash on delivery for orders over a threshold or for international shipping.
 * Rename a method — for example "Stripe" becomes "Credit / debit card".
 * Reorder methods — promote your preferred or lowest-fee option to the top of
   the radio list.

Your underlying payment providers configured in Settings → Payments are
unchanged. The app only changes how the list appears at checkout, per cart.


EXAMPLES

 * Hide cash on delivery when the order total is over $500, where COD refusal
   rates spike.
 * Hide regional methods (Razorpay, iDEAL) when the ship-to country doesn't
   match.
 * Rename "Stripe" to "Credit / debit card" so shoppers see a familiar label.
 * Add a fee disclosure to a method name: "Cash on delivery (+$2 handling)".
 * Promote your highest-converting method to the top of the list.


WHAT YOU'LL SEE

On the checkout's Payment step, the shopper sees only the customized list —
methods you hid are gone, renames replace the built-in labels, and the order
matches what your customization app produced.

If a stale checkout tries to submit a hidden method, the order placement is
rejected server-side with a clear message ("Payment method '<name>' is not
available for this order"). The shopper can't get past the hide by manipulating
the page.


INSTALLING AN APP THAT USES THIS

 1. Open Apps → Marketplace in your admin.
 2. Browse payment apps and open one that fits your need.
 3. Review the permissions and click Install.
 4. Configure the rules (cart-total thresholds, country conditions, rename
    labels) in the app's settings.
 5. Test with carts that match and don't match each rule to confirm the right
    methods appear.


LIMITS AND TIPS

 * You can have up to 5 payment customization apps active at once. They run in
   install order. If two apps try to rename the same method, the last one wins;
   a hide from any app removes the method entirely.
 * Never hide every method. If no payment method is available for a cart, the
   shopper literally can't pay. Always leave at least one method available for
   any reachable cart.
 * Rename text shows up everywhere on checkout — keep labels short so they don't
   wrap badly on mobile.
 * Customizations don't change how charges work. Renaming "Stripe" to "Credit
   card" only changes the radio label; the payment still processes through the
   underlying provider exactly as configured.
 * Removing the app reverts the list. Your methods reappear with their original
   names and order on the next checkout.


FOR DEVELOPERS

If you want to build an app that uses a payment customization function, see the
developer documentation at docs.launchmystore.io
[https://docs.launchmystore.io].