This article describes the differences between your Default Checkout and Custom Checkouts and how to configure the Payment Methods and options available on each.
When creating Invoices, Payment Links, Events, Virtual POS Terminals and using other commerce products in Zaprite, such as our API, you will have the option to choose your Default Checkout, or build a Custom Checkout.
Default Checkout
This is the default Checkout you must configure in Order to accept payments. It will be used whenever a Custom Checkout is not configured.
Your Default Checkout is configured in the same manner as creating a Custom Checkout below.
Note: Your Default Checkout can be configured by clicking on Checkout on the main navigation menu.
Custom Checkout
Clicking Custom when creating or editing an Invoice, Payment Link, Event or other product will override your Default Checkout and assign a Custom Checkout for that item only. It does not effect your Default Checkout configuration or any other Checkout.
If you have created a Custom Checkout when creating or editing an individual Invoice, Payment Link, etc., any subsequent changes to your Default Checkout will have no effect on your Custom Checkouts.
It is important to note that if you make any changes to your Default Checkout, these will not be reflected in individual Custom Checkouts. They will only effect any Checkout that has 'Default' selected. You will have to edit any item that has Custom selected in order to make any adjustments.
Payment Methods
Each Checkout must have at least one Payment Method active.
Payment Methods | Bitcoin, Lightning, Fiat, USDT, USDC. |
Connections
The Checkout configurator shows you a list of your active Connections as well as their respective Payment Method. You can enable or disable Connections using the toggle for each item. You can also drag to arrange the order of your enabled options.
Payment options enabled will be displayed on the Checkout as individual choices for your Customer to pay. Each option will display any relevant Discount or Premium information offered.
Payment Method Conflicts
You may only have one Connection enabled for each Payment Method active on a Checkout. For example, you may only have one Lightning option and/or one Bitcoin option enabled.
If you try to enable a second Connection for a Payment Method you will be presented with a modal asking if you would like to swap your active Connections for that Payment Method.
Payment Method Restrictions
Some Connections and/or Payment Methods may have restrictions and will be disabled and not shown on Checkouts.
Restrictions may include:
Minimum payment thresholds
Currency availability
Any applicable restrictions are generally shown on the Connection's Settings screen after you have successfully connected your wallet, exchange or payment processor.
Discounts/Premiums
You can opt to add a Discount or Premium to any Payment Method. For example, you may add a Discount on Bitcoin or Lightning payments to incentivise customers to pay in BTC. Or you may choose to add a Premium to all Fiat payments to account for any third-party charges or precessing fees.
Any Discount or Premium added will be highlighted on the Checkout Configurator screen next to any applicable Connections.
Note: At present you can only add Discounts or Premiums to top-level Payment Methods such as Bitcoin, Lightning, Fiat. In the future we plan to add options for each payment type (e.g. Credit Card, ACH, etc.).
Notifications
Zaprite includes a notification system that may alert you when issues arise with certain Connections. Types of events that can trigger an email notification:
If a payment intent fails (e.g. Account locked)
If we cannot generate payment information (e.g. a Lightning invoice from a node or exchange)