Skip to content

Merchant Logo

Ondřej Zaoral edited this page Jun 17, 2022 · 1 revision

The payment gateway can be personalized using your own branding assets. The end-to-end payment process will be more trusted by your clients and they will know that they are “still with you”, even after the redirection to the payment gateway. You will just need to upload the logo to the ČSOB POS Merchant system.

Logo file requirements

Format: PNG

Size: 240 x 100px or 480 x 200px

Recommended background colour: transparent or white

Maximum size: 500kB

Should your logo be round or square, please place it horizontally and vertically in the middle of the available space.

Guide for logo file upload and activation in the integration environment

We strongly recommend that you test the logo in the integration environment (called on https://iapi.iplatebnibrana.csob.cz) and fine-tune e.g. the size and position of the logo. You can try multiple strategies and select the best option for you. Logos are not subject to approval in the integration environment - therefore you can iterate fast.

  1. Upload the logo file to ČSOB POS Merchant - Integration environment, provide a name (“version”) when uploading
  2. You will see the newly uploaded logo in the list
  3. Activate the logo (it will not be shown on the gateway without activation)
  4. The logo will be shown on the gateway page within 5 minutes from activation in step 3

Guide for logo file upload, activation and approval in the production environment

The bank approved the logo files for use in the production environment. Please upload only files you tested and fine-tuned in the integration environment.

  1. Upload the logo file to ČSOB POS Merchant, provide a name (“version”) when uploading
  2. You will see the newly uploaded logo in the list, waiting for approval
  3. As soon as the logo is approved, please activate the logo (it will not be shown on the gateway without activation)
  4. The logo will be shown on the gateway page within 5 minutes from activation in step 3

Temporary (e.g. seasonal) logo file switch

If you want to temporarily use a different logo (e.g. for Christmas), do not delete the logo file you are currently using. Multiple files can be uploaded and approved in the payment gateway system. Just deactivate the current logo and activate the temporary logo (after it has been approved by the bank) in the ČSOB POS Merchant. You can switch back to the current logo anytime, without the need to approve it again.

Multibranding

Shops selling under multiple brands (the seller being one entity) can use the multibrading feature of the gateway. Starting with eAPI 1.6, you can set your logo in the payment/init call (using the parameter logoVersion). Your colour scheme can be set in the same way (parameter colorSchemeVersion). Please note you always need to use approved versions.

Clone this wiki locally