Auto fulfill and capture delay
How fulfillment settings decide when order items are marked fulfilled and when an authorized payment is captured, so you can take the money only after shipping.
Some merchant agreements say you may take the money only once you ship. The payment is authorized at checkout (the money is held), and captured (taken) when the goods leave. Your fulfillment settings can do this for you, so a shipped order is never left uncaptured.
Change them in the dashboard under Settings > Fulfillment, or with Update fulfillment settings.
| Dashboard | API field | Default |
|---|---|---|
| Automatically Fulfill Items | auto_fulfill_items | false |
| Automatic Fulfillment Delay (hours) | auto_fulfill_delay (0 to 168) | 0 |
| Automatically Capture Payments | auto_capture | true |
| Automatic Capture Delay (hours) | auto_capture_delay (0 to 168) | 0 |
When items are fulfilled
- Digital items and services are marked fulfilled as soon as the order is made.
- Physical items with
auto_fulfill_itemson are marked fulfilled when the order is made, orauto_fulfill_delayhours later when you set a delay. - Physical items with
auto_fulfill_itemsoff are marked fulfilled when your shipments cover their whole quantity. See Create a shipment.
When every item is fulfilled, the order's fulfilled becomes true and order:fulfilled fires.
When the payment is captured
- A payment sent with
capture: trueorcapture: falsedoes what it says. This overrides the settings below (a limited token cannot send it). - An order with no physical items is captured at once.
- With
auto_captureon and no delay, the payment is captured at once. - With
auto_captureon and a delay, the payment is only authorized and is capturedauto_capture_delayhours later. - With
auto_captureoff, the payment is only authorized.
In every case, when the order becomes fulfilled, each payment still authorized on it is captured. You can also capture at any time with Capture an order.
Capture when you ship
To take the money only once the goods ship, turn Automatically Capture Payments off. Orders with physical items are then authorized only, and captured when the order is fulfilled. Then pick how fulfillment happens:
- You mark shipments. Leave Automatically Fulfill Items off. The capture happens when your shipments cover every item.
- Comecero marks them after a delay. Turn Automatically Fulfill Items on and set Automatic Fulfillment Delay to the hours you usually need to ship, such as 24 or 48. When the delay passes, the items are marked fulfilled and the payment is captured a minute or two later. You never miss a capture because a shipment was not entered.
With Automatically Fulfill Items on and a delay of 0, items are fulfilled when the order is made and the money is captured at once.
If you cannot ship an order, void it before the capture so the shopper's money is released. After the capture, refund it instead.
An authorization does not last forever: the card network and gateway release held money after some days. Keep your delays shorter than the time your gateway holds an authorization.
Gateway weight
How the gateway weight decides which payment gateway takes a payment when more than one can, and how backup gateways and gateway attempts work.
Shipping by quantity
Price a shipping method by the number of physical items in the order, with a price per item and flat prices for quantity ranges, in one or more currencies.