TransactionEditRequest

Passthrough-only transaction edit payload. Use only for PSP flows where Koard forwards EMV data and later receives the final transaction state back from the PSP.

Partial-update semantics: omitted fields and fields set to null are preserved (unchanged). Only fields with an explicit non-null value are updated. A provided breakdown fully replaces the existing breakdown — sub-amounts are not merged.

  • authorized_amount
    Type: integer | null

    Replacement authorized amount in cents.

  • breakdown
    Type: nullable

    Replacement breakdown used when editing passthrough transactions.

    Properties: 6
  • refunded
    Type: integer | null

    Replacement cumulative refunded amount in cents.

  • reversed
    Type: integer | null

    Replacement cumulative reversed amount in cents.

  • status
    Type: enumnullable

    Current status of a transaction. The surcharge_pending status indicates the transaction is awaiting cardholder confirmation of a surcharge via the confirm endpoint. surcharge_declined_by_payer means the cardholder rejected the surcharge and the transaction was canceled.

    values
    • pending
    • authorized
    • captured
    • settled
    • declined
    • refunded
    • reversed
    • canceled
    • error
    • surcharge_pending
    • surcharge_declined_by_payer
  • status_reason
    Type: string | null

    Replacement status reason for the transaction.