Transactions

Update a transaction.

Changed on Nov 3, 2026

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.

patch/transactions/{transaction_id}

Request

Base URL
https://sandbox.alloy.co/v1
Auth
- OAuth 2
  Client credentials
  Token URL/oauth/bearer
- or HTTP basic
TypeScript
https://skmtc.dev/alloy/apis/alloy-api/docs/transactions/:transaction_id/patch.ts
A function with typed inputs. Its response is checked against the schema.

Request body

transaction_idunknown

transaction_datestring

ISO 8601 date. Used as the transaction's date or date to look back from when evaluating an account.

amountinteger

Amount in cents

currencystring

3-character currency code (e.g. "USD")

Platform or process method of the transaction. Allowed values are ("Card". "Internal", "Check", "P2P", "ACH", "Cash", "Wire", "Digital Wallet", null)

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)

Where the transaction took place. Allow values are ("Android", "ATM", "Card Swipe Terminal", "iOS", "Mobile", "Online Form", "Point of Sale", "QR", "Teller", "3rd Party App", null)

type_codestring 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_descriptionstring 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_approvedboolean nullable

If the transaction was approved by the customer

is_reversalboolean nullable

If the transaction is a refund

is_triggered_by_userboolean nullable

Whether the transaction is initiated by the source entity. Mainly used to distinguish between ACH push and pull

is_international_overrideboolean nullable

True if the transaction is international

return_codestring 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_modenumber nullable

POS entry modes on card transactions

response_codenumber nullable

Response codes returned on card transactions

Allowed values are ("Acknowledged", "Accepted", "Rejected", "Paused", "Pending", "Completed", "Declined", "Cancelled", null)

status_detailstring nullable

Additional description on transaction status. Currently not used in decisioning.

iso_messagenumber nullable

ISO standard value returned on card transactions

settled_atstring nullable

ISO 8601 date. Currently not used in decisioning.

latest_transaction_datestring nullable

ISO 8601 date. Currently not used in decisioning.

descriptionstring nullable

A description of the transaction. Currently not used in decisioning.

approval_codestring nullable

The raw approval code provided by the customer. Currently not used in decisioning.

transaction_metaobject nullable

Object containing extra raw data not stored in other columns. Currently not used in decisioning.

Example request

{
  "source": {
    "external_account_id": "test-account-001",
    "account_class": "deposit",
    "entities": [
      {
        "external_entity_id": "entity-01",
        "account_holder_type": "primary"
      }
    ],
    "account_snapshot": {
      "timestamp": "2022-03-21T21:50:07.623Z",
      "details": {
        "status": "Active"
      }
    }
  },
  "destination": {
    "external_account_id": "test-account-001",
    "account_class": "deposit",
    "entities": [
      {
        "external_entity_id": "entity-01",
        "account_holder_type": "primary"
      }
    ],
    "account_snapshot": {
      "timestamp": "2022-03-21T21:50:07.623Z",
      "details": {
        "status": "Active"
      }
    }
  }
}

Response

Transaction updated successfully.

transaction_idunknown

transaction_datestring

ISO 8601 date. Used as the transaction's date or date to look back from when evaluating an account.

amountinteger

Amount in cents

currencystring

3-character currency code (e.g. "USD")

Platform or process method of the transaction. Allowed values are ("Card". "Internal", "Check", "P2P", "ACH", "Cash", "Wire", "Digital Wallet", null)

Where the transaction took place. Allow values are ("Android", "ATM", "Card Swipe Terminal", "iOS", "Mobile", "Online Form", "Point of Sale", "QR", "Teller", "3rd Party App", null)

type_codestring 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_descriptionstring 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_approvedboolean nullable

If the transaction was approved by the customer

is_reversalboolean nullable

If the transaction is a refund

is_triggered_by_userboolean nullable

Whether the transaction is initiated by the source entity. Mainly used to distinguish between ACH push and pull

is_international_overrideboolean nullable

True if the transaction is international

return_codestring 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_modenumber nullable

POS entry modes on card transactions

response_codenumber nullable

Response codes returned on card transactions

Allowed values are ("Acknowledged", "Accepted", "Rejected", "Paused", "Pending", "Completed", "Declined", "Cancelled", null)

status_detailstring nullable

Additional description on transaction status. Currently not used in decisioning.

iso_messagenumber nullable

ISO standard value returned on card transactions

settled_atstring nullable

ISO 8601 date. Currently not used in decisioning.

latest_transaction_datestring nullable

ISO 8601 date. Currently not used in decisioning.

descriptionstring nullable

A description of the transaction. Currently not used in decisioning.

approval_codestring nullable

The raw approval code provided by the customer. Currently not used in decisioning.

transaction_metaobject nullable

Object containing extra raw data not stored in other columns. Currently not used in decisioning.

Example response

{
  "source": {
    "external_account_id": "test-account-001",
    "account_class": "deposit",
    "entities": [
      {
        "external_entity_id": "entity-01",
        "account_holder_type": "primary"
      }
    ],
    "account_snapshot": {
      "timestamp": "2022-03-21T21:50:07.623Z",
      "details": {
        "status": "Active"
      }
    }
  },
  "destination": {
    "external_account_id": "test-account-001",
    "account_class": "deposit",
    "entities": [
      {
        "external_entity_id": "entity-01",
        "account_holder_type": "primary"
      }
    ],
    "account_snapshot": {
      "timestamp": "2022-03-21T21:50:07.623Z",
      "details": {
        "status": "Active"
      }
    }
  }
}

Changes

Nov 3, 2026615aa97a5ddb Revision changes
- breaking
  added to the request body allOf list
- warning
  removed subschema #1 from the request body allOf list
- info
  added to the response body allOf list for the response status
- info
  removed from the response body allOf list for the response status

Operation history

Update a transaction.

Request

Request body

Example request

Response 200OK

Example response

Changes

Response