comecerodocs
Settings

Get pricing settings

GET
/settings/pricing

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.

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

Response Body

The pricing settings.

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 GET 'https://api.comecero.com/api/v1/settings/pricing'
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"    }  ]}

Update payment settings POST

Changes the payment settings. Send only the fields you want to change. `allow_save_cards` is set by Comecero and ignored if you send 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_payment`. Limited tokens may not.

Update pricing settings POST

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.