# Order limits per payment method

> Set the smallest and largest order each way to pay takes, limit cards on a buyer's first order, and decide how short a crypto payment may be.

Source: https://shopfa.st/docs/selling/order-limits

Some ways to pay suit some orders better than others. Cards can be charged back, so many stores keep big orders off
them. Crypto has network fees, so tiny crypto orders cost more than they are worth. Order limits let you set this per
way to pay, and checkout follows them.

## Set your limits

Open **Money → Payments → Checkout rules** and find **Order limits by payment method**, right under **At checkout**. For each kind of
payment, set a smallest order, a largest order, or both:

| Kind of payment | Covers |
| --- | --- |
| Cards and wallets | Cards, Apple Pay and Google Pay, from any gateway (ShopFast Pay, Stripe, PayPal's card option, plugins) |
| PayPal | PayPal from any gateway |
| Crypto | Your own wallet, BTCPay Server and crypto plugins |
| Bank transfer and manual | Bank transfers and your manual methods |

Limits measure the order total after discounts, before tax and gift cards. Leave a field empty for no limit. Store
credit is never limited.

**Cards on a first order.** Turn on **Limit cards on a buyer's first order** and set an amount: buyers with no paid
order at your store yet can pay by card only up to it. Orders that were refunded or charged back do not count as
history. Above the amount, they see your other ways to pay.

The card shows a live example as you type: "A $250 cart can pay with: Crypto, PayPal", and which methods are hidden
and why. It runs the same rules checkout does.

## What buyers see

Checkout only offers the ways to pay that fit the order, and says why a method is missing, in one plain line:

> Card payments are available up to $200 at this store.

When nothing fits the order, the buyer reads the limit instead of a generic error. ShopFast checks the limits again
when the buyer pays, so a method sent from an old page or straight to the API is refused with a `409`
`payment-method-limit` problem whose `fields[0]` points at `body.method`.

**Payment failover** follows your limits too: after a declined payment, the next ways to pay offered are only the ones
that fit this order.

## ShopFast's caps

ShopFast can set hard limits per kind of payment and currency, for example a largest card order for every store. Your
own limits always stay inside them: a largest order above the cap is pulled in to the cap when you save (the page says
so), and the cap applies even if you set nothing. The card shows the cap next to each kind of payment.

## Crypto: how short a payment may be

Wallets sometimes take the network fee out of the amount, so a crypto payment can arrive a little short. In
**Money → Payments → Crypto**, under **Price lock and edge cases**:

- **Accept an underpayment of up to**: a share of the order (up to 5%).
- **Or a fixed amount short**: an amount in your currency, for small orders where a share is only cents.

Whichever is more counts, rounded down so it never goes past what you allowed (and the fixed amount never forgives more than 10% of the order).
For example 1% or $0.50: a $20 order counts as paid up to $0.50 short, a $200 order up to $2 short.

A payment short by more than that waits: the buyer sees what arrived, the exact amount still to send and a countdown
(**Time to send the rest**). If the rest does not arrive in time, the payment becomes **partly paid**. The buyer reads
that part of the payment arrived and that you will complete the order or send the coins back, and the payment waits
for you under **Crypto payments**, where you can accept it or mark it refunded.