Docs
Dashboard
View as Markdown
On this page
  1. Set your limits
  2. What buyers see
  3. ShopFast’s caps
  4. Crypto: how short a payment may be

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.

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.

Was this page helpful?