<!-- ZenPays documentation · https://docs.zenpayz.com/docs/reference/objects/merchant-profile -->

# The MerchantProfile object

Represents a merchant's profile in the ZenPays system. The merchant profile contains business information and configuration settings for payment processing.

## Fields

<ParamTable
  label="Field"
  rows={[
    { name: "id", type: "string", required: true, desc: "Unique identifier for the merchant" },
    { name: "name", type: "string", required: true, desc: "Business or display name" },
    { name: "email", type: "string", required: true, desc: "Primary email address" },
    { name: "phone", type: "string", required: false, desc: "Contact phone number" },
    { name: "logo", type: "string", required: false, desc: "URL to the merchant's logo" },
    { name: "website", type: "string", required: false, desc: "Business website URL" },
    { name: "description", type: "string", required: false, desc: "Brief description of the business" },
    { name: "businessType", type: "string", required: false, desc: "Type of business (e.g., 'ecommerce', 'saas', 'marketplace')" },
    { name: "country", type: "string", required: false, desc: "Two-letter ISO country code where the business is registered" },
    { name: "timezone", type: "string", required: false, desc: "Timezone identifier (e.g., 'America/New_York')" },
    { name: "defaultCurrency", type: "string", required: false, desc: "Default currency for transactions" },
    { name: "kycStatus", type: "KycStatus", required: false, desc: "KYC verification status [KycStatus](/docs/reference/enums/compliance)" },
    { name: "isActive", type: "boolean", required: true, desc: "Whether the merchant account is active" },
    { name: "createdAt", type: "string", required: true, desc: "ISO 8601 timestamp when the merchant was created" },
    { name: "updatedAt", type: "string", required: true, desc: "ISO 8601 timestamp when the merchant was last updated" },
  ]}
/>

## Example

```json
{
  "id": "obj_1a2b3c",
  "name": "string",
  "email": "customer@example.com",
  "phone": "string",
  "logo": "string",
  "website": "string",
  "description": "string",
  "businessType": "string",
  "isActive": false,
  "createdAt": "2026-01-15T09:30:00Z",
  "updatedAt": "2026-01-15T09:30:00Z"
}
```