> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://beta-docs.payabli.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://beta-docs.payabli.com/_mcp/server.

# TransEvent reference

Transaction events are notes about each event that a transaction goes through during its lifecycle. This reference covers the most common `TransEvent` values.

Most of the time, the `EventData` object contains more details about the `TransEvent`. For example `EventData` may contain information about why an operation failed, or a substatus explaining more about the event.

## Money in transaction events

<table>
  <thead>
    <tr>
      <th>
        TransEvent
      </th>

      <th>
        Description
      </th>

      <th>
        Maps To
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        ACH Return
      </td>

      <td>
        Transaction has an ACH return.
      </td>

      <td>
        [-2 (ACH Return or Chargeback)](/references/money-in-statuses#payment-funding-status)
      </td>
    </tr>

    <tr>
      <td>
        Approved
      </td>

      <td>
        Transaction approved.
      </td>

      <td>
        [1 (Approved)](/references/money-in-statuses#money-in-transaction-status)
      </td>
    </tr>

    <tr>
      <td>
        Authorized
      </td>

      <td>
        Transaction authorized.
      </td>

      <td>
        [11 (Authorized)](/references/money-in-statuses#money-in-transaction-status)
      </td>
    </tr>

    <tr>
      <td>
        Capture
      </td>

      <td>
        Authorized transaction captured.
      </td>

      <td>
        [1 (Captured)](/references/money-in-statuses#money-in-transaction-status)
      </td>
    </tr>

    <tr>
      <td>
        Capture Declined
      </td>

      <td>
        Authorized transaction capture failed.
      </td>

      <td>
        [2 or 3 (Declined)](/references/money-in-statuses#money-in-transaction-status)
      </td>
    </tr>

    <tr>
      <td>
        Cfee Split
      </td>

      <td>
        Event related to batches and funding.
      </td>

      <td>
        N/A
      </td>
    </tr>

    <tr>
      <td>
        Chargeback
      </td>

      <td>
        Transaction has a chargeback.
      </td>

      <td>
        [-2 (ACH Return or Chargeback)](/references/money-in-statuses#payment-funding-status)
      </td>
    </tr>

    <tr>
      <td>
        Closed Batch
      </td>

      <td>
        Batch closed.
      </td>

      <td>
        [1 (Closed)](/references/money-in-statuses#batch-status)
      </td>
    </tr>

    <tr>
      <td>
        Compensation
      </td>

      <td>
        Event related to batches and funding.
      </td>

      <td>
        N/A
      </td>
    </tr>

    <tr>
      <td>
        Created
      </td>

      <td>
        The first event for a transaction, created automatically when a transaction is started.
      </td>

      <td>
        N/A
      </td>
    </tr>

    <tr>
      <td>
        Declined
      </td>

      <td>
        Transaction declined.
      </td>

      <td>
        [2 or 3 (Declined)](/references/money-in-statuses#money-in-transaction-status)
      </td>
    </tr>

    <tr>
      <td>
        Hold
      </td>

      <td>
        Transaction or batch held.
      </td>

      <td>
        -5 (Held) in 

        [transactions](/references/money-in-statuses#payment-funding-status)

         or 

        [batch](/references/money-in-statuses#batch-status)

         statuses.
      </td>
    </tr>

    <tr>
      <td>
        Refund
      </td>

      <td>
        Transaction refunded.
      </td>

      <td>
        N/A
      </td>
    </tr>

    <tr>
      <td>
        Refund Declined
      </td>

      <td>
        Transaction refund failed.
      </td>

      <td>
        N/A
      </td>
    </tr>

    <tr>
      <td>
        Refund (Split)
      </td>

      <td>
        Transaction with split instructions refunded.
      </td>

      <td>
        N/A
      </td>
    </tr>

    <tr>
      <td>
        Released
      </td>

      <td>
        Transaction released.
      </td>

      <td>
        [-6 (Released)](/references/money-in-statuses#payment-funding-status)
      </td>
    </tr>

    <tr>
      <td>
        Returned
      </td>

      <td>
        Transaction has a chargeback or ACH return.
      </td>

      <td>
        [-2 (ACH Return or Chargeback)](/references/money-in-statuses#payment-funding-status)
      </td>
    </tr>

    <tr>
      <td>
        Settled
      </td>

      <td>
        Batch or transaction settled.
      </td>

      <td>
        3 (Settled) in 

        [batches](/references/money-in-statuses#batch-status)

        , 

        [payment funding](/references/money-in-statuses#payment-funding-status)

        , and 

        [transfer](/references/money-in-statuses#transfer-status)

         statuses, depending on the context.
      </td>
    </tr>

    <tr>
      <td>
        Split
      </td>

      <td>
        Transaction split.
      </td>

      <td>
        N/A
      </td>
    </tr>

    <tr>
      <td>
        Transferred
      </td>

      <td>
        Funds transferred.
      </td>

      <td>
        2 (Transferred) in 

        [batches](/references/money-in-statuses#batch-status)

        , 

        [payment funding](/references/money-in-statuses#payment-funding-status)

        , and 

        [transfer](/references/money-in-statuses#transfer-status)

         statuses, depending on the context.
      </td>
    </tr>

    <tr>
      <td>
        Void
      </td>

      <td>
        Transaction voided.
      </td>

      <td>
        [5 (Voided/Canceled)](/references/money-in-statuses#money-in-transaction-status)
      </td>
    </tr>

    <tr>
      <td>
        Void Declined
      </td>

      <td>
        Transaction void failed.
      </td>

      <td>
        N/A
      </td>
    </tr>
  </tbody>
</table>

## Money out transaction events

<table>
  <thead>
    <tr>
      <th>
        TransEvent
      </th>

      <th>
        Description
      </th>

      <th>
        Maps To
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Authorized
      </td>

      <td>
        A payout is authorized. These are queued payouts, and nothing happens with them until they're captured.
      </td>

      <td>
        [11 (Authorized)](/references/money-out-statuses#payout-transaction-statuses)
      </td>
    </tr>

    <tr>
      <td>
        Captured
      </td>

      <td>
        A payout is captured and is now part of the batch for payout.
      </td>

      <td>
        [1 (Captured)](/references/money-out-statuses#payout-transaction-statuses)
      </td>
    </tr>

    <tr>
      <td>
        Capture Declined
      </td>

      <td>
        Authorized transaction capture failed.
      </td>

      <td>
        N/A
      </td>
    </tr>

    <tr>
      <td>
        Cancelled
      </td>

      <td>
        An authorized payout has been cancelled. A captured payout can be cancelled before batch close at 5 PM ET.
      </td>

      <td>
        [0 (Cancelled)](/references/money-out-statuses#payout-transaction-statuses)
      </td>
    </tr>

    <tr>
      <td>
        Cancel Declined
      </td>

      <td>
        Transaction cancellation failed.
      </td>

      <td>
        N/A
      </td>
    </tr>

    <tr>
      <td>
        Closed Batch
      </td>

      <td>
        Batch closed.
      </td>

      <td>
        [1 (Closed)](/references/money-out-statuses#batch-statuses)
      </td>
    </tr>

    <tr>
      <td>
        Created
      </td>

      <td>
        The first event for a transaction, created automatically when a transaction is started.
      </td>

      <td>
        N/A
      </td>
    </tr>

    <tr>
      <td>
        Waiting funds
      </td>

      <td>
        A payout is being processed.
      </td>

      <td>
        [2 (Processing)](/references/money-out-statuses#payout-transaction-statuses)
      </td>
    </tr>

    <tr>
      <td>
        Funded
      </td>

      <td>
        A payout is being processed.
      </td>

      <td>
        [2 (Processing)](/references/money-out-statuses#payout-transaction-statuses)
      </td>
    </tr>

    <tr>
      <td>
        Pending (payment type is pending)
      </td>

      <td>
        A payout is being processed.
      </td>

      <td>
        [2 (Processing)](/references/money-out-statuses#payout-transaction-statuses)
      </td>
    </tr>

    <tr>
      <td>
        Generating check
      </td>

      <td>
        A payout is being processed.
      </td>

      <td>
        [2 (Processing)](/references/money-out-statuses#payout-transaction-statuses)
      </td>
    </tr>

    <tr>
      <td>
        Open
      </td>

      <td>
        ACH sent, vCard issued, check generated but not yet cashed. A payment method is defined for the vendor, and the payout has been sent to the recipient, but hasn't been redeemed.
      </td>

      <td>
        [3 (Processed)](/references/money-out-statuses#payout-transaction-statuses)
      </td>
    </tr>

    <tr>
      <td>
        Processed
      </td>

      <td>
        Payment Type is no longer pending.
      </td>

      <td>
        [3 (Processed)](/references/money-out-statuses#payout-transaction-statuses)
      </td>
    </tr>

    <tr>
      <td>
        Reissued
      </td>

      <td>
        A payment method has been reissued.
      </td>

      <td>
        [3 (Processed)](/references/money-out-statuses#payout-transaction-statuses)
      </td>
    </tr>

    <tr>
      <td>
        Returned
      </td>

      <td>
        Payment has been returned.
      </td>

      <td>
        [3 (Processed)](/references/money-out-statuses#payout-transaction-statuses)
      </td>
    </tr>

    <tr>
      <td>
        Errored
      </td>

      <td>
        There was an error in processing the payment.
      </td>

      <td>
        [3 (Processed)](/references/money-out-statuses#payout-transaction-statuses)
      </td>
    </tr>

    <tr>
      <td>
        Paid
      </td>

      <td>
        A payout has been paid and the recipient has redeemed the funds. The vCard has been used, the check has been cashed, or the ACH has settled.
      </td>

      <td>
        [5 (Paid)](/references/money-out-statuses#payout-transaction-statuses)
      </td>
    </tr>
  </tbody>
</table>