Overview
The Checkout Branding API generates customized payment logo images by specifying payment types, colors, dimensions, and templates through URL parameters.https://checkout.dintero.com/v1/branding/logos/{logos}/variant/{variant}/color/{color}/width/{width}/{template}.svg
URL parameters
A list of payment logos separated by underscores (_).Example: visa_mastercard_applepay_googlepay_vipps_mobilepay_swish_walley_klarna_billie_clicktopayAvailable logos: visa mastercard vipps swish walley klarna applepay googlepay mobilepay billie clicktopay two kravia
Style variant for the logos.| Value | Description |
|---|
colors | Colorful logos with full branding |
mono | Monochrome version |
darkcolors | Optimized for dark backgrounds |
logomark | Payment logos only, no Dintero branding |
smallmark | Smaller payment logos only, no Dintero branding |
RGB hex code without the # character.Examples: 444444, ee00eeFor colors and darkcolors variants, color applies to text and frame elements only. Does not apply to logomark and smallmark variants.
Image width in pixels. Recommended range: 400–600px.Examples: 600, 450, 800
Layout template for the logo display.| Value | Description |
|---|
dintero_top_frame | Secure payment text above, logos below |
logos | Logos only, no text |
logo | A single logo (the first one in /logos/) |
Use your payment profile instead of manually specifying logos. The profile automatically shows all configured payment methods and updates when you change them in your Dintero account.https://checkout.dintero.com/v1/branding/accounts/{account_id}/profiles/{profile_id}/variant/{variant}/color/{color}/width/{width}/{template}.svg
https://checkout.dintero.com/v1/branding/accounts/P11223351/profiles/P11223351.5GdDG8rrepTQKhrEqzoRSQ/variant/colors/color/cfcfcf/width/600/dintero_top_frame.svg
Complete examples
Variant: colors
https://checkout.dintero.com/v1/branding/logos/visa_mastercard_applepay_vipps_klarna/variant/colors/color/171717/width/600/dintero_top_frame.svg
Variant: mono
https://checkout.dintero.com/v1/branding/logos/visa_mastercard_applepay_vipps_klarna/variant/mono/color/444444/width/600/dintero_top_frame.svg
Variant: darkcolors
https://checkout.dintero.com/v1/branding/logos/visa_mastercard_applepay_vipps_klarna/variant/darkcolors/color/eeeeee/width/600/dintero_top_frame.svg
Variant: logomark
No Dintero branding. Secure payment text is hidden.https://checkout.dintero.com/v1/branding/logos/visa_mastercard_applepay_vipps_klarna/variant/logomark/color/444444/width/600/logos.svg
Variant: smallmark
Smaller logos, no Dintero branding.https://checkout.dintero.com/v1/branding/logos/visa_mastercard_applepay_vipps_klarna/variant/smallmark/color/444444/width/600/logos.svg
Best practices
- Choose logos that match your accepted payment methods.
- Use the
darkcolors variant on dark backgrounds for better visibility.
- Keep width between 400–600px for optimal display on most devices.
- Use
logomark to minimize branding and focus on payment options; use smallmark for a smaller size.
- Match the
color parameter to your website’s text or border color.
- Test the generated SVG in your environment before deploying to production.
