Merchant Logo
Overview
Merchants can include their branded logo in CCG-generated email templates (e.g., payment confirmation emails, wallet invitation emails). The logo is referenced by URL and is automatically resized to a height of 32px — width adjusts proportionally.
info
The merchant logo is used exclusively in email templates. It does not appear inside the widget UI itself.
Configuration
Set the merchantLogo field inside the appearance object of the POST /sessions request.
const appearance = {
merchantLogo: 'https://your-domain.com/logo.png',
};
Pass appearance as part of your session request:
{
"appearance": {
"merchantLogo": "https://your-domain.com/logo.png"
}
}
Requirements
| Requirement | Details |
|---|---|
| Format | Valid absolute URL (https://) |
| File type | PNG, SVG, or JPEG recommended |
| Rendered height | Automatically resized to 32px — width is dynamic |
| Hosting | Must be publicly accessible (no auth required) |
| HTTPS | Required — HTTP URLs will be blocked by email clients |
Logo Visibility in Widget Header
The CCG widget also displays a header logo (the CCG default). You can hide this using the headerLogo visibility flag — this is separate from merchantLogo.
const appearance = {
visibility: {
headerLogo: false, // hide the CCG header logo inside the widget
},
merchantLogo: 'https://your-domain.com/logo.png', // used in emails only
};