Managing Tender Types FAQ

This page answers common questions about how tender types are configured, inherited, and applied across partners, merchants, and terminals.

Tender types determine which payment methods are available to customers during checkout and on the hosted payment page.

How are tender types determined?

Tender types are determined across three levels.

Partner level defines which tender types are commercially available. Merchant level inherits tender types from the partner. Terminal level enables or disables specific tender types for that terminal.

Most integrations interact with tender types at the terminal level.

Do I need to configure tender types during merchant onboarding?

No. Merchant onboarding automatically inherits all tender types enabled for the partner.

There is no additional API step required to assign tender types at the merchant level.

Where should I configure tender types?

Tender types should be configured during terminal creation or updated later using the update terminal endpoint.

This allows you to tailor payment methods per device, channel, or use case.

Why does a tender type not appear on my terminal?

Common reasons include:

• The tender type is not enabled at the partner level

• The terminal has not been updated to include the tender type

• The terminal is using a default configuration that excludes non-default tender types

If a tender type is not enabled at the partner level, it will not be available for activation on any terminal.

Can different terminals for the same merchant support different tender types?

Yes. Tender types are configured at the terminal level, so terminals under the same merchant may support different payment methods.

What happens if new tender types are added later?

When new tender types are enabled at the partner level, they become available for future terminal configurations.

Existing terminals will not automatically change unless they are explicitly updated.

How do tender types affect the hosted payment page?

Only tender types enabled on the terminal will appear on the hosted payment page for that terminal.

If a tender type is not enabled, it will not be shown to the customer.

Can I change tender types after payments have started?

Yes. Tender types can be updated on a terminal at any time.

Changes apply only to new payment sessions created after the update.

Where can I find the API details for managing tender types?

Tender types are managed as part of terminal creation and terminal updates.

Refer to the Terminal Management documentation for request and response examples. https://developers.bead.xyz/entity-management/terminal-management