# Save Refunds

Save Refunds

Endpoint: POST /rest/2.0/REFUND
Version: 1.0
Security: JWT

## Header parameters:

  - `sessionId` (string, required)

## Request fields (application/json; charset=utf-8):

  - `brmObjects` (object)

  - `brmObjects.Id` (string, required)
    Refund Item ID

  - `brmObjects.PaymentItemId` (integer, required)
    PaymentItemId

  - `brmObjects.RefundType` (string, required)
    Refund Type

  - `brmObjects.Note` (string, required)
    Refund Notes

  - `brmObjects.VoidRefundItemId` (integer)
    Voided By

  - `brmObjects.Status` (string, required)
    Status

  - `brmObjects.Created` (string)
    System controlled field: Date and time the record was created

  - `brmObjects.CreatedUserId` (string)
    System controlled field: Id of the user that created the record

  - `brmObjects.UpdatedUserId` (string)
    System controlled field: Id of the last user that updated the record

  - `brmObjects.VoidedRefundId` (integer)
    Voided To

  - `brmObjects.GatewayTransactionId` (string)
    Gateway Transaction Id

  - `brmObjects.VoidFlag` (string)
    Voided

  - `brmObjects.AccountingPeriodId` (integer)
    Accounting Period

  - `brmObjects.gatewayResponseMessage` (string)
    Gateway Response Message

  - `brmObjects.gatewayResponseCode` (string)
    Gateway Response Code

  - `brmObjects.Updated` (string)
    System controlled field: Date and time the record was last updated

## Response 200 fields (application/json):

  - `retrieveResponse` (object)

  - `retrieveResponse.Id` (string)
    Refund Item ID

  - `retrieveResponse.PaymentItemId` (integer)
    PaymentItemId

  - `retrieveResponse.RefundType` (string)
    Refund Type

  - `retrieveResponse.Note` (string)
    Refund Notes

  - `retrieveResponse.VoidRefundItemId` (integer)
    Voided By

  - `retrieveResponse.Status` (string)
    Status

  - `retrieveResponse.Created` (string)
    System controlled field: Date and time the record was created

  - `retrieveResponse.CreatedUserId` (string)
    System controlled field: Id of the user that created the record

  - `retrieveResponse.UpdatedUserId` (string)
    System controlled field: Id of the last user that updated the record

  - `retrieveResponse.VoidedRefundId` (integer)
    Voided To

  - `retrieveResponse.GatewayTransactionId` (string)
    Gateway Transaction Id

  - `retrieveResponse.VoidFlag` (string)
    Voided

  - `retrieveResponse.AccountingPeriodId` (integer)
    Accounting Period

  - `retrieveResponse.gatewayResponseMessage` (string)
    Gateway Response Message

  - `retrieveResponse.gatewayResponseCode` (string)
    Gateway Response Code

  - `retrieveResponse.Updated` (string)
    System controlled field: Date and time the record was last updated

## Response 400 fields (application/json):

  - `error` (string)
    Bad request

  - `message` (string)
    Bad request

## Response 401 fields (application/json):

  - `error` (string)
    Unauthorized

  - `message` (string)
    Unauthorized

## Response 404 fields (application/json):

  - `error` (string)
    Not found

  - `message` (string)
    Not found

## Response 429 fields (application/json):

  - `error` (string)
    Too many requests

  - `message` (string)
    Too many requests

## Response 500 fields (application/json):

  - `error` (string)
    Internal error

  - `message` (string)
    Internal error