comecerodocs
Settings

Update pricing settings

POST
/settings/pricing

Changes the markup and rounding rules. Each list you send replaces the saved list. New conversions use the new rules at once. 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_pricing. 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 pricing rules to change. Each list you send replaces the saved list.

Properties1 <= properties
currency_rounding_rules?array<>|

The full list of rounding rules.

currency_markup_rules?array<>

The full list of markup rules.

Response Body

The pricing settings, after the change.

application/json
  1. response

How prices are converted into other currencies in the current mode: the markup on the exchange rate and how the result is rounded.

object?"settings_pricing"

The object type. Always settings_pricing.

Value in"settings_pricing"
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
currency_rounding_rules?array<>

Rounding rules, one per currency, plus an optional default rule (currency null).

currency_markup_rules?array<>

Exchange rate markups, one per currency, plus an optional default rule (currency null). With no rule, the markup is 3%.

formatted?

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

Example Request
curl -X POST 'https://api.comecero.com/api/v1/settings/pricing' \  -H 'Content-Type: application/json' \  -d '{  "currency_markup_rules": [    {      "currency": null,      "markup_percentage": 0.03    },    {      "currency": "JPY",      "markup_percentage": 0.04    }  ]}'
Example Response
{  "object": "settings_pricing",  "url": "https://api.comecero.com/api/v1/settings/pricing",  "account_id": "AB1234",  "test": true,  "date_modified": "2026-10-02T14:21:07Z",  "currency_rounding_rules": [    {      "currency": null,      "method": "highest",      "minimum": 3,      "positions": [        0,        0.25,        0.5,        0.75,        0.95,        0.99      ],      "date_created": "2026-10-02T14:21:07Z"    }  ],  "currency_markup_rules": [    {      "currency": null,      "markup_percentage": 0.03,      "date_created": "2026-10-02T14:21:07Z"    }  ]}

Get pricing settings GET

Returns the exchange rate markups and rounding rules used when a price is converted into another currency. 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_pricing`. Limited tokens may not.

Get shipping settings GET

Returns the shipping settings with every shipping method. 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_shipping`. Limited tokens may not.