Merchant Settings

Configure general merchant account settings.

Get Settings

curl https://dev.auxcore.net/api/v1/merchants/merchant_123/settings

Response:

{
  "success": true,
  "data": {
    "businessName": "ACME Corp",
    "businessEmail": "contact@acme.com",
    "businessPhone": "+1234567890",
    "timezone": "America/New_York",
    "currency": "USD",
    "notificationEmail": "notifications@acme.com"
  }
}

Update Settings

curl -X PUT https://dev.auxcore.net/api/v1/merchants/merchant_123/settings \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Tenant-ID: your-tenant-id" \
  -H "Content-Type: application/json" \
  -d '{
    "businessName": "ACME Corporation",
    "timezone": "America/Los_Angeles",
    "notificationEmail": "admin@acme.com"
  }'

Response:

{
  "success": true,
  "data": {
    "businessName": "ACME Corporation",
    "timezone": "America/Los_Angeles",
    "notificationEmail": "admin@acme.com",
    "updatedAt": "2026-01-28T12:00:00Z"
  }
}

Available Settings

Setting	Type	Description
`businessName`	string	Legal business name
`businessEmail`	email	Primary contact email
`businessPhone`	phone	Primary contact phone
`timezone`	string	Merchant timezone (TZ format)
`currency`	string	Default currency (ISO 4217)
`notificationEmail`	email	Email for system notifications
`statementDescriptor`	string	Descriptor on statements
`supportUrl`	url	Customer support URL

Best Practices

Keep contact info current - Ensures important notifications reach you
Set correct timezone - Affects settlement schedules
Use clear statement descriptor - Reduces chargebacks

Need help? Contact support@auxvault.com