Coinvay’s default Free plan allows 100 created invoices per UTC month, but administrators can change plan limits. The allowance measures invoice creation, not simply the number of successful customer payments.
Count requests, not just paid receipts
Creating a live invoice consumes the current month’s allowance even when it is later abandoned or cancelled. This encourages an integration to create a payment request deliberately instead of creating a new invoice on every page refresh. Reuse the saved invoice mapping and an order-specific Idempotency-Key for retries of the same intended order. Testnet checkout records created through the merchant Sandbox do not use this live allowance.
Understand what happens at the limit
When the configured cap is reached, new invoice creation is restricted unless the merchant upgrades or an administrator changes the entitlement. Existing blockchain funds are already in the receiving wallet; the plan limit does not create a Coinvay-held balance or freeze that wallet. Already-created invoices remain separate records with their own status and validity rules. Handle the plan-restriction response in your checkout so a buyer sees a useful support message rather than an endless payment spinner.
Plan around UTC and legitimate demand
For example, a merchant creating ninety-five invoices near month end has five remaining under a 100-invoice cap, regardless of how many paid. The allowance is tracked by UTC month, which may differ from the merchant’s local midnight. Check Plans & billing for the actual configured cap and current usage rather than relying on an old marketing screenshot. If legitimate volume is growing, compare plan capacity and required features before the limit interrupts new orders. Do not delete historical invoices to try to manufacture unused allowance.
Practical checklist
- Read the current plan limit and usage in Plans & billing.
- Use stable invoice mappings and idempotency keys instead of creating replacement requests on refresh.
- Handle HTTP 402 plan restrictions distinctly from unpaid customer invoices.
Common questions
Does 100 invoices mean 100 successful payments?+
No. The default cap counts created invoices, including later-cancelled ones. Successful settlement is a different metric.
Will reaching the cap prevent me from accessing my wallet?+
No. Direct-to-wallet funds remain under your wallet’s control. The cap restricts new application invoice creation, not ownership of received assets.
Sources and further reading
Primary references and Coinvay product documentation. Check the linked pages for current details.
AI-assisted drafting, published by Coinvay. Examples are illustrative. Read our editorial approach.