Confirm Request

Request body for confirming or declining a surcharge-pending transaction. After a payment returns surcharge_pending status, the client must present the surcharge to the cardholder and call confirm with the result.

  • confirm
    Type: boolean · Confirm
    required

    Whether the cardholder accepted the surcharge. true processes the payment with surcharge applied; false cancels the transaction.

  • amount
    Type: integer | null · Amount

    Optional override of the total transaction amount in cents. If not provided, the original calculated amount (including surcharge) is used.

  • breakdown
    Type: object · Breakdown (with Surcharge) nullable

    Optional updated breakdown with surcharge details.

    • subtotal
      Type: integer · Subtotal
      required

      Subtotal amount in cents before tax, tip, and surcharge.

    • surcharge
      Type: object · Surcharge nullable

      Surcharge configuration. When provided, surcharge is calculated and applied to the transaction total.

    • taxAmount
      Type: integer | null · Taxamount

      Tax amount in cents.

    • taxRate
      Type: number | null · Taxrate

      Tax rate as a float (e.g., 8.75 for 8.75%). Integer values >= 100 are auto-divided by 100 for backward compatibility.

    • tipAmount
      Type: integer | null · Tipamount

      Tip amount in cents.

    • tipRate
      Type: number | null · Tiprate

      Tip rate as a float (e.g., 15.0 for 15%). Integer values >= 100 are auto-divided by 100 for backward compatibility.

    • tipType
      Type: string | null · Tiptype

      Tip calculation method. One of: fixed, percentage.

  • event_id
    Type: string | null · Event Id

    Idempotency key for this confirmation event. If not provided, one is generated server-side.