BitcartCC Basics
Deployment
Guides
Integrations
Examples
Support and Community
Transaction speed
Transaction speed
What does transaction speed mean?
First of all, transaction speed applies only to on-chain invoices. All lightning invoices are instantly marked as complete.
To understand why transaction speed setting is needed, you need to understand the invoice statuses in BitcartCC:
When invoice has just been created, it has
pending status.If no payment has been sent within the invoice time frame (expiration time), invoice is marked
expired. Expired invoices no longer listen for incoming payments, but you may manually mark it complete.If a payment has been sent within the invoice time frame (expiration time), invoice status is set to
paid.With
paid status, customer is redirected to the redirect URL, and checkout page shows paid. But all the notifications, emails and custom scripts aren't executed yet.When payment has been confirmed (has >= 1 confirmations), invoice status is set to
confirmed.When payment's number of confirmations is >= transaction speed, invoice status is set to
complete, and all the postorder actions are executed (like notifications).So, transaction speed controls how fast you want your invoice to be complete. Default value of 0 provides the fastest checkout, but it is not always good for your use case, it might be not safe.
Value of 1 means waiting for one confirmation, which is enough in most cases.
You can set transaction speed to any value between 0 and 6 (there is no point in waiting past 6 confirmations).
​
Last modified 11mo ago
Copy link