Sign in

v66

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-042174421.1 MB
Event Types

payment_transaction.updated

Occurs when a payment transaction is updated.

postWebhookpayment_transaction.updated

Payload

event_type'payment_transaction.updated' required

The type of event that occurred.

status'PENDING' | 'SETTLED' | 'DECLINED' | 'REVERSED' | 'CANCELED' | 'RETURNED' required
tokenstring uuid required

Unique identifier for the transaction

createdstring date-time required

ISO 8601 timestamp of when the transaction was created

updatedstring date-time required

ISO 8601 timestamp of when the transaction was last updated

family'PAYMENT' required

PAYMENT - Payment Transaction

category'ACH' | 'WIRE' | 'STABLECOIN' | 'BALANCE_OR_FUNDING' | 'FEE' | 'REWARD' | 'ADJUSTMENT' | 'DERECOGNITION' | 'DISPUTE' | 'CARD' | 'EXTERNAL_ACH' | 'EXTERNAL_CHECK' | 'EXTERNAL_FEDNOW' | 'EXTERNAL_RTP' | 'EXTERNAL_TRANSFER' | 'EXTERNAL_WIRE' | 'MANAGEMENT_ADJUSTMENT' | 'MANAGEMENT_DISPUTE' | 'MANAGEMENT_FEE' | 'MANAGEMENT_REWARD' | 'MANAGEMENT_DISBURSEMENT' | 'HOLD' | 'PROGRAM_FUNDING' | 'PROGRAM_TRANSFER' required

Note: Inbound wire transfers are coming soon (availability varies by partner bank). The WIRE category is a preview. To learn more, contact your customer success manager.

currencystring

Currency of the transaction in ISO 4217 format

result'APPROVED' | 'DECLINED' required
financial_account_tokenstring uuid required

Financial account token

external_bank_account_tokenstring uuid nullable

External bank account token

direction'CREDIT' | 'DEBIT' required

Transfer direction

source'LITHIC' | 'EXTERNAL' | 'CUSTOMER' required

Transaction source

method'ACH_NEXT_DAY' | 'ACH_SAME_DAY' | 'WIRE' required

Transfer method

settled_amountinteger required

Settled amount in cents

pending_amountinteger required

Pending amount in cents

descriptorstring required

Transaction descriptor

user_defined_idstring nullable

User-defined identifier

expected_release_datestring date nullable

Expected release date for the transaction

type'ORIGINATION_CREDIT' | 'ORIGINATION_DEBIT' | 'RECEIPT_CREDIT' | 'RECEIPT_DEBIT' | 'WIRE_INBOUND_PAYMENT' | 'WIRE_INBOUND_ADMIN' | 'WIRE_OUTBOUND_PAYMENT' | 'WIRE_OUTBOUND_ADMIN' | 'WIRE_INBOUND_DRAWDOWN_REQUEST'
tagsTags

Key-value pairs for tagging resources. Tags allow you to associate arbitrary metadata with a resource for your own purposes.

Example payload

{
  "category": "ACH",
  "family": "PAYMENT",
  "created": "2023-09-14T12:52:44Z",
  "currency": "USD",
  "descriptor": "custom description",
  "direction": "DEBIT",
  "events": [
    {
      "amount": 4103,
      "created": "2023-09-14T12:52:44Z",
      "result": "APPROVED",
      "token": "f274f723-b156-5b15-a96d-5ba8d5241b09",
      "type": "ACH_ORIGINATION_INITIATED"
    },
    {
      "amount": 4103,
      "created": "2023-09-14T12:52:46Z",
      "result": "APPROVED",
      "token": "95719c03-7eb8-560b-9843-39da92df5231",
      "type": "ACH_ORIGINATION_PROCESSED"
    },
    {
      "amount": 4103,
      "created": "2023-09-14T12:52:47Z",
      "result": "APPROVED",
      "token": "87fea0af-931f-5e80-a9cf-a243aa71b89d",
      "type": "ACH_ORIGINATION_RELEASED"
    }
  ],
  "external_bank_account_token": "b05c313e-35db-4b47-a33b-7b268d72b1f5",
  "financial_account_token": "39ec6bf0-c101-520e-965a-a4fffce1d755",
  "related_account_tokens": null,
  "method": "ACH_NEXT_DAY",
  "method_attributes": {
    "retries": 0,
    "return_reason_code": null,
    "sec_code": "CCD",
    "addenda": null
  },
  "pending_amount": 0,
  "result": "APPROVED",
  "settled_amount": 4103,
  "source": "CUSTOMER",
  "status": "SETTLED",
  "token": "147595d7-45f4-4c91-a950-3436d16847e5",
  "updated": "2023-09-14T12:52:47Z",
  "user_defined_id": null
}

Response

Return a 200 status to indicate that the data was received successfully