Amount Selection Link

This feature allows merchants to offer customers different predefined amounts or let them enter a custom amount to make a payment.

Main Features

Assisted Payment with Selection Option

The amount selection link allows the merchant to generate a unique link with the option to convert it into a QR code if desired, which the customer can open on their device to:

• Choose from a list of predefined amounts configured by the merchant.

• Or, if allowed by the merchant, manually enter a custom amount within the set limits.

Ideal for flexible sales, donations, top-ups, or any flow where amount options are offered to the customer.

Configurable Expiration Date

• The merchant can define a custom expiration date for the link.

• If not specified, the system will apply a default expiration.

• This improves security and prevents links from being exposed for excessive periods.

Dynamic Behavior Based on Configuration

• If a fixed amount is defined (amount), the system generates a direct link to pay that specific amount.

• If no amount is defined and a list of amounts is provided, the customer can select from the available options.

This flexibility allows the link to be adapted to the specific sales or service flow.

Secure Transaction

Transactions initiated through this type of link:

• Are associated with an authenticated merchant via secure mechanisms.

• Are processed on encrypted channels and comply with data protection requirements.

• Allow full traceability for audit purposes.

Usage Flow

1. The merchant calls the POST /link/amount-selection API, sending an object that may contain:

   • A fixed [amount] for immediate payment.

   • Or a list [amounts] with selectable predefined amounts.

2. The system generates a secure payment link.

3. The merchant sends the link to the customer.

4. The customer:

   • If multiple amounts are available, chooses one on screen.

   • Or if the link is direct to a specific amount, simply pays.

5. The system records the transaction as IN_PROGRESS until its payment or expiration.

Considerations

• The [amount] and the list [amounts] are mutually exclusive: if [amount] is defined, [amounts] should not be defined.

• The amounts in [amounts] must comply with business rules:

  • Must be within the [minAmount] and [maxAmount] limits if configured.

• Must be multiples of amountMultiple if this property is defined.

• The expirationDate must be a future date.

• Links should be treated as sensitive; do not expose them publicly without control.