---
title: "Update a transaction."
method: PATCH
path: "/transactions/{transaction_id}"
tags: ["Transactions"]
deprecated: true
---

# Update a transaction.

`PATCH /transactions/{transaction_id}`

> **Deprecated.**

Updates a Transaction by external transaction ID.

*Note*: If you are using the Alloy Events API, you do not need to use any of the Transactions endpoints. All data should be sent through the Events API with a relevant `event_type`.

## Request body

- object
  - `transaction_id` unknown
  - `transaction_date` string — ISO 8601 date. Used as the transaction's date or date to look back from when evaluating an account.
  - `amount` integer — Amount in cents
  - `currency` string — 3-character currency code (e.g. "USD")
  - `source` 0 — unresolved $ref
  - `destination` 0 — unresolved $ref
  - `account_snapshot` object, nullable — Snapshot of the source account of the transaction. Note that this is not a separate call, it is part of either an /accounts call or an /evaluations call
    - `timestamp` string, date, required — ISO 8601 timestamp of the account snapshot.
    - `meta` object — JSON object with any meta information related to the account snapshot.
    - `details` object — JSON object with any details related to the account snapshot.
      - `status` string
      - `status_detail` string
      - `loan_credit_limit` integer
      - `interest_rate` number
      - `original_interest_rate` number
      - `original_amount` integer
      - `ach_push_limit` integer
      - `ach_pull_limit` integer
      - `name_first` string
      - `name_last` string
      - `email_address` string
      - `phone_number` string
      - `mailing_address_line1` string
      - `mailing_address_line2` string
      - `mailing_address_city` string
      - `mailing_address_state` string
      - `mailing_address_postal_code` string
      - `mailing_address_country_code` string — 3-character country code (e.g. "USA")
      - `primary_address_line1` string
      - `primary_address_line2` string
      - `primary_address_city` string
      - `primary_address_state` string
      - `primary_address_postal_code` string
      - `primary_address_country_code` string — 3-character country code (e.g. "USA").
    - `account_view` object — JSON object
      - `account_balance` integer — Account balance in cents.
      - `date_last_activity` string — ISO 8601 timestamp of last activity.
      - `is_good_standing` boolean
      - `past_due_days` integer
  - `process_method` 'Card' | 'Internal' | 'Check' | 'P2P' | 'ACH' | 'Cash' | 'Wire' | 'RTP', nullable — Platform or process method of the transaction. Allowed values are (`"Card"`. `"Internal"`, `"Check"`, `"P2P"`, `"ACH"`, `"Cash"`, `"Wire"`, `null`)
  - `category` 'Adjustment' | 'ATM Rebate' | 'Bill Pay' | 'Chargeback' | 'Deposit' | 'Direct Deposit Bonus' | 'Interest' | 'Overdraft Fee' | 'Payment' | 'Promo' | 'Purchase' | 'Purchase Return' | 'Return' | 'Service Charge' | 'Withdrawal', nullable — Splits process_method into more granular values. Allowed values are (`"Adjustment"`, `"ATM Rebate"`, `"Bill Pay"`, `"Chargeback"`, `"Deposit"`, `"Direct Deposit Bonus"`, `"Interest"`, `"Overdraft Fee"`, `"Payment"`, `"Promo"`, `"Purchase"`, `"Purchase Return"`, `"Return"`, `"Service Charge"`, `"Withdrawal"`, `null`)
  - `interaction_point` 'Android' | 'ATM' | 'Card Swipe Terminal' | 'iOS' | 'Mobile' | 'Online Form' | 'Point of Sale' | 'Teller' | '3rd Party App', nullable — Where the transaction took place. Allow values are (`"Android"`, `"ATM"`, `"Card Swipe Terminal"`, `"iOS"`, `"Mobile"`, `"Online Form"`, `"Point of Sale"`, `"Teller"`, `"3rd Party App"`, `null`)
  - `type_code` string, nullable — The raw type code of the transaction. There should be a 1:1 mapping from type_code to type_description provided to Alloy.
  - `type_description` string, nullable — Description of the type code. There should be a 1:1 mapping from type_code to type_description provided to Alloy. Currently not used in decisioning.
  - `is_approved` boolean, nullable — If the transaction was approved by the customer
  - `is_reversal` boolean, nullable — If the transaction is a refund
  - `is_triggered_by_user` boolean, nullable — Whether the transaction is initiated by the source entity. Mainly used to distinguish between ACH push and pull
  - `is_international_override` boolean, nullable — True if the transaction is international
  - `return_code` string, nullable — This represents the Alphanumeric ACH return Code. (e.g. R01)
  - `return_code_reason` 'Unauthorized', nullable — Allowed values are (`"Unauthorized"`, `null`). Currently not used in decisioning.
  - `entry_mode` number, nullable — POS entry modes on card transactions
  - `response_code` number, nullable — Response codes returned on card transactions
  - `status` 'Acknowledged' | 'Accepted' | 'Rejected' | 'Paused' | 'Pending' | 'Completed' | 'Declined' | 'Cancelled', nullable — Allowed values are (`"Acknowledged"`, `"Accepted"`, `"Rejected"`, `"Paused"`, `"Pending"`, `"Completed"`, `"Declined"`, `"Cancelled"`, `null`)
  - `status_detail` string, nullable — Additional description on transaction status. Currently not used in decisioning.
  - `iso_message` number, nullable — ISO standard value returned on card transactions
  - `settled_at` string, nullable — ISO 8601 date. Currently not used in decisioning.
  - `latest_transaction_date` string, nullable — ISO 8601 date. Currently not used in decisioning.
  - `description` string, nullable — A description of the transaction. Currently not used in decisioning.
  - `approval_code` string, nullable — The raw approval code provided by the customer. Currently not used in decisioning.
  - `transaction_meta` object, nullable — Object containing extra raw data not stored in other columns. Currently not used in decisioning.

## Response `200`

Transaction updated successfully.

- 0 — unresolved $ref

---

[API](https://skmtc.dev/alloy/apis/alloy-api.md) · [All operations](https://skmtc.dev/alloy/apis/alloy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alloy/alloy-api/revisions/405799de4d2a/schema)