Surcharge

Set amount OR percentage, never both. bypass=true requires both to be omitted. Percentage uses whole percent units, such as 3.5 for 3.5%. Amount is in minor currency units.

  • amount
    Type: integer | null

    Fixed surcharge amount in cents. Mutually exclusive with percentage.

  • bypass
    Type: boolean

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

  • percentage
    Type: number | null

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