comecerodocs

Update fulfillment settings

POST
/settings/fulfillment

Changes the capture and fulfillment rules. Send only the fields you want to change. The change applies to payments and orders made after it. Settings are kept per mode: a test token works on the test settings, a live token on the live ones. Secret and trusted tokens may call it when their permissions include settings_fulfillment. Limited tokens may not.

Authorization

headerAuthorizationBearer <token>

A secret, trusted or limited token. See Authentication.

Query Parameters

show?string

Comma-separated fields to return; all others are left out. Use dot notation for child fields (customer.email). You cannot send show and hide together (400). See Customizing output.

hide?string

Comma-separated fields to leave out of the response. Use dot notation for child fields (customer.email). You cannot send show and hide together (400). See Customizing output.

formatted?boolean

When true, the object also has a formatted child with amounts and dates as display text in the shopper's language and currency (for example $19.99 or November 7, 2026). The default is false. See Localized formatting.

Defaultfalse

Request Body

application/json
  1. body

The fulfillment fields to change. Send only the fields you want to change.

Properties1 <= properties
auto_fulfill_items?boolean

Mark order items as fulfilled automatically.

auto_fulfill_delay?integer

Hours to wait before items are marked as fulfilled.

Range0 <= value <= 168
auto_capture?boolean

Capture payments automatically.

auto_capture_delay?integer

Hours to wait before a payment is captured.

Range0 <= value <= 168
low_inventory_notification?integer

The stock level that triggers a low inventory notice.

Response Body

The fulfillment settings, after the change.

application/json
  1. response

How the account captures payments and marks items as fulfilled, in the current mode.

object?"settings_fulfillment"

The object type. Always settings_fulfillment.

Value in"settings_fulfillment"
url?string

The URL of this object.

Formaturi
account_id?string

The ID of the account the settings belong to.

test?boolean

True for the test mode settings, false for live.

date_modified?string

When the settings were last changed.

Formatdate-time
auto_fulfill_items?boolean

Mark order items as fulfilled automatically. When false, you mark them yourself (for example with a shipment). Default false.

auto_fulfill_delay?integer

With auto_fulfill_items, how many hours to wait before items are marked as fulfilled. From 0 to 168. Default 0.

Range0 <= value <= 168
auto_capture?boolean

Capture payments automatically. When false, payments are only authorized and you capture them yourself. Default true.

auto_capture_delay?integer

With auto_capture, how many hours to wait before a payment is captured. From 0 to 168. Default 0.

Range0 <= value <= 168
low_inventory_notification?number

Send a low inventory notice when a product's stock falls to this number. Default 10. Saved as a whole number.

formatted?

Display text for the dates. Returned only when formatted=true.

Example Request
curl -X POST 'https://api.comecero.com/api/v1/settings/fulfillment' \  -H 'Content-Type: application/json' \  -d '{  "auto_capture": true,  "auto_capture_delay": 24}'
Example Response
{  "object": "settings_fulfillment",  "url": "https://api.comecero.com/api/v1/settings/fulfillment",  "account_id": "AB1234",  "test": true,  "date_modified": "2026-10-02T14:21:07Z",  "auto_fulfill_items": false,  "auto_fulfill_delay": 0,  "auto_capture": true,  "auto_capture_delay": 0,  "low_inventory_notification": 10}