Retrieve merchant settings

GET/settings

Retrieve your business configuration: test/live mode, per-chain signer status, the PaymentFactory address needed to sign direct payments, and the settlement address. These values are stable — fetch once and cache them with your config.

Headers

Header	Description	Required
Authorization	Bearer token with your secret API key	yes

Example Request

Request

const response = await fetch('https://checkout-api.exodus-int.com/settings', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxx',
  },
});

Responses

Status	Description
200	The merchant settings.
400	Validation error
401	Missing or invalid authentication

Response body

Field	Type	Required
business_id	string	yes
business_name	string	yes
is_test	boolean	yes
settlement_type	enum: CRYPTO \| FIAT	yes
currency	string \| null	yes
settlement_provider	string \| null	yes
settlement_provider_id	string \| null	yes
chain_configs	object[]	yes
can_generate_key	boolean	yes
webhook_url	string \| null	yes

chain_configs

Field	Type	Required
chain_family	enum: evm \| solana	yes
signer_status	enum: not_configured \| pending_activation \| active	yes
merchant_signer	string \| null	yes
settlement_address	string \| null	yes
factory_address	string \| null	yes

Example Response

{
  "business_id": "biz_1234567890abcdef",
  "business_name": "Acme Store",
  "is_test": false,
  "settlement_type": "CRYPTO",
  "currency": null,
  "settlement_provider": null,
  "settlement_provider_id": null,
  "chain_configs": [
    {
      "chain_family": "evm",
      "signer_status": "active",
      "merchant_signer": "0x1234abcd1234abcd1234abcd1234abcd1234abcd",
      "settlement_address": "0xabcd1234abcd1234abcd1234abcd1234abcd1234",
      "factory_address": "0xfaceb00cfaceb00cfaceb00cfaceb00cfaceb00c"
    },
    {
      "chain_family": "solana",
      "signer_status": "active",
      "merchant_signer": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
      "settlement_address": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9",
      "factory_address": null
    }
  ],
  "can_generate_key": false,
  "webhook_url": "https://yoursite.com/webhooks/exodus"
}

Error Response

Error (e.g. 400)

{
  "error": {
    "type": "validation_error",
    "message": "amount must be a positive number",
    "param": "amount"
  }
}

Overview Register a merchant signer and settlement address