comecerodocs
Settings reference

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.

DashboardAPI fieldDefault
Automatically Fulfill Itemsauto_fulfill_itemsfalse
Automatic Fulfillment Delay (hours)auto_fulfill_delay (0 to 168)0
Automatically Capture Paymentsauto_capturetrue
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_items on are marked fulfilled when the order is made, or auto_fulfill_delay hours later when you set a delay.
  • Physical items with auto_fulfill_items off 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

  1. A payment sent with capture: true or capture: false does what it says. This overrides the settings below (a limited token cannot send it).
  2. An order with no physical items is captured at once.
  3. With auto_capture on and no delay, the payment is captured at once.
  4. With auto_capture on and a delay, the payment is only authorized and is captured auto_capture_delay hours later.
  5. With auto_capture off, 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.

On this page