Refund Request

Refund request model. Supports card-present refunds with reader data.

  • amount
    Type: integer | null · Amount

    Refund amount in cents. If omitted, the full original transaction amount is refunded.

  • card_reader_data
    Type: object · Card Read Data nullable

    Card reader data from a tap-to-pay or terminal interaction.

    • generalCardData
      Type: string · Generalcarddata
      required

      Encrypted general card data (TLV-encoded).

    • id
      Type: string · Id
      required

      Unique transaction identifier generated by the client SDK.

    • outcome
      Type: integer · Outcome
      required

      Card read outcome code from the NFC/EMV kernel.

    • paymentCardData
      Type: string · Paymentcarddata
      required

      Encrypted payment card data (TLV-encoded).

    • isPINFallback
      Type: boolean · Ispinfallback

      Whether the transaction fell back to PIN entry.

    • pinBypassed
      Type: boolean · Pinbypassed

      Whether PIN entry was bypassed.

  • event_id
    Type: string | null · Event Id

    Idempotency key. Auto-generated if omitted.

  • transaction_id
    Type: string | null · Transaction Id

    ID of the original transaction to refund.