Merchants

Update Current Merchant

Update the current merchant's information. Only the merchant associated with the bearer token is updated.

POST
/merchants/current

Authorization

bearerAuth
AuthorizationBearer <token>

Use your secret API key as the bearer token

In: header

Request Body

application/json

legalName?string
displayName?string
taxId?string|null
websiteUrl?string|null
defaultCurrency?string

Default currency code

supportEmail?string|null
Formatemail
billingEmail?string|null
Formatemail
phoneNumber?string|null
addressLine1?string
addressLine2?string|null
city?string
stateProvince?string|null
postalCode?string
country?string

ISO 2-letter country code

timezone?string|null
invoicePrefix?string|null

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://api.getlumen.dev/v1/merchants/current" \  -H "Content-Type: application/json" \  -d '{    "displayName": "Acme Billing",    "supportEmail": "support@acme.com",    "billingEmail": "billing@acme.com",    "addressLine1": "123 Market St",    "city": "San Francisco",    "postalCode": "94105",    "country": "US",    "defaultCurrency": "USD",    "timezone": "America/Los_Angeles"  }'
{
  "id": "mer_7X2FxYk1zv3p4LqB0sDn",
  "legalName": "Acme Inc.",
  "displayName": "Acme Billing",
  "websiteUrl": "https://acme.com",
  "supportEmail": "support@acme.com",
  "billingEmail": "billing@acme.com",
  "defaultCurrency": "USD",
  "addressLine1": "123 Market St",
  "city": "San Francisco",
  "postalCode": "94105",
  "country": "US",
  "updatedAt": "2025-02-21T10:00:00.000Z"
}
{
  "error": [
    {
      "code": "invalid_type",
      "message": "Required",
      "path": [
        "legalName"
      ]
    }
  ]
}
{
  "error": "string",
  "details": "string"
}
{
  "error": "Internal server error"
}