---
title: "Refund a transaction"
method: POST
path: "/transactions/refund/ach"
tags: ["Transactions"]
---

# Refund a transaction

`POST /transactions/refund/ach`

Called by the Independent Software Vendor. Makes a request to TB in order to get a refund amount for an ACH transaction.

## Headers

- `Authorization` string, api_id:api_token, required
- `Accept` string, required
- `Content-Type` string, required

## Response `200`

Success

- object
  - `amount` string — Passthrough of original transaction request amount
  - `auth_amount` string — The authorized amount in case of a partial authorized transaction
  - `gateway_auth_code` string — The authorization code received from the gateway
  - `card_type` string — The type of the card that was submitted. Allowed values - `"Discover"`, `"DISCOVER"`, `"UnionPay"`, `"AmEx"`, `"AMERICAN EXPRESS"`, `"AMEX"`, `"American express"`, `"Master"`, `"MASTERCARD"`, `"Mastercard"`, `"MASTERCARD/Mastercard"`, `"JCB"`, `"Jcb"`, `"Visa"`, `"VISA"`,`"Visa Traditional"`, `"Visa Classic"`, `"Visa Health"`, `"Visa Prefered"`, `"Mastercard/Eurocard"`, `"DINERS"`, `"CareCredit"`, `"Unknown Code"`, `"OTHER"`, `"null"`, `"N/A"` The values are subject to change.
  - `created_at` string — The time the transaction was created.
  - `gateway_identifier` 'usaepay' | 'payment_fusion' — Identifier of the gateway.
  - `gateway_reference_number` string — Transaction reference number from gateway.
  - `gateway_response_message` string — The message returned from the gateway
  - `gateway_result_code` string — Result code (or error code) as returned by the gateway
  - `gateway_result_text` string — The result text as returned by the gateway.
  - `merchant_id` string — The merchant identifier that will be used to connect to the gateway. Size range - `1..16`
  - `mid` string — The merchant ID
  - `remote_id` string — Used for keeping track of a 3rd party identifier alongside the transaction object. This is typically used by the ISV to assign its own identifier to the transaction for easy matching in case any network issues appear. This is not validated for uniqueness. Size range - `0..256`.
  - `tid` string — The terminal ID
  - `tip_amount` string — The tip amount in USD that was added to this transaction. Default value - `0`
  - `transaction_status` string — Confirmation from the payment gateway regarding the CC credentials and payment finalization. Allowed values - `"approved"`, `"awaiting_amount"`, `"awaiting_confirmation"`, `"canceled"`, `"declined"`, `"emv_needing_reversal"`, `"error"`, `"in progress"`, `"internal error"`, `"timeout"`, `"verification"`, `"Success"`, `"Failure"`
  - `v` string — The API version that was used to handle the request.

## Other responses

- `4XX` — Possible errors - 1, 5, 6, 9, 10, 11, 57, 81, 83, 189, 208, 231, 232, 240, 250, 251
- `5XX` — Possible errors - 8, 12

---

[API](https://skmtc.net/bankofamerica/apis/transaction-broker-api.md) · [All operations](https://skmtc.net/bankofamerica/apis/transaction-broker-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bankofamerica/transaction-broker-api/revisions/6097bc689e41/schema)