Surcharge

Surcharge configuration for a transaction. Only one of amount or percentage may be set. When bypass is true, neither amount nor percentage should be provided.

  • amount
    Type: integer | null · Amount

    Fixed surcharge amount in cents. Mutually exclusive with percentage.

  • bypass
    Type: boolean · Bypass

    When true, surcharge calculation is skipped entirely for this transaction. Must be false when amount or percentage is provided.

  • percentage
    Type: number | null · Percentage

    Surcharge rate as a decimal (e.g., 3.5 for 3.5%). Mutually exclusive with amount.