Checkout Payment Tolerance Added

BlockBee has introduced a new Payment Tolerance setting to help merchants avoid payments getting stuck in a partial state due to small underpayments. This feature allows you to accept slightly incomplete payments caused by network fees, rounding, wallet behavior, or exchange withdrawal fees deducted from the sent amount.

Why Payment Tolerance Matters

In real-world crypto payments, the amount received is not always exactly the amount requested. This is especially common when customers pay from exchanges, since many exchanges deduct their withdrawal fee directly from the amount being sent.

When the received amount is slightly lower than expected, the payment is not rejected, but it can remain in a partial state and keep requesting the missing amount. In practice, customers usually do not come back to complete it.

Payment Tolerance solves this by allowing merchants to automatically accept near-complete payments and continue their normal flow without manual follow-ups.

How It Works

Payment Tolerance is configured as a percentage value from 0% to 10% (integer values only).

Example:

• Requested payment: $100
• Payment tolerance: 5%
• Minimum accepted payment: $95

If the customer sends $95 or more, the payment is accepted as complete and processed normally. Payments below that threshold still remain partial and behave as they always have.

Important Notes

Payment Tolerance does not change what was actually paid. It only changes how BlockBee evaluates completion within your defined threshold.

• The blockchain transaction remains unchanged
• The webhook always contains the actual amount paid, not the requested value
• This feature is meant to handle minor discrepancies, not to encourage underpayment

Available Now

Payment Tolerance is available now and can be configured from your dashboard in Payment Settings. If you want fewer payments stuck in partial and a smoother checkout experience, this update is designed for you.