Register a merchant signer and settlement address
POST/settingsRegister the merchant signer and settlement address for a chain family, activating signed-request verification for that chain.
Headers
| Header | Description | Required |
|---|---|---|
| Authorization | Bearer token with your secret API key | yes |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| merchant_signer | string | yes | |
| chain_family | enum: evm | solana | — | |
| settlement_address | string | yes |
Example Request
Request
const response = await fetch('https://checkout-api.exodus-int.com/settings', {
method: 'POST',
headers: {
Authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxx',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"merchant_signer": "string",
"chain_family": "evm",
"settlement_address": "string"
}),
});Responses
| Status | Description |
|---|---|
| 201 | The updated merchant settings. |
| 400 | Validation error |
| 401 | Missing or invalid authentication |
Response body
| Field | Type | Required | Description |
|---|---|---|---|
| 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 | Description |
|---|---|---|---|
| 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"
}
}