> ## Documentation Index
> Fetch the complete documentation index at: https://developers.ingopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Account Transfer Exception

> Fired when an entity transaction ledgering operation fails (e.g. an inbound credit cannot be matched to a VBAN). The transaction is posted to the program balance. The reference block carries bank-file context.



## AsyncAPI

````yaml specs/asyncapi-banking.yaml AccountTransferException
id: AccountTransferException
title: Account Transfer Exception
description: >-
  Fired when an entity transaction ledgering operation fails (e.g. an inbound
  credit cannot be matched to a VBAN). The transaction is posted to the program
  balance. The reference block carries bank-file context.
servers:
  - id: webhook
    protocol: https
    host: your-webhook-endpoint.example.com
    bindings: []
    variables: []
address: account.transfer.exception
parameters: []
bindings: []
operations:
  - &ref_1
    id: receiveAccountTransferException
    title: Receive account transfer exception
    description: Account Transfer Exception
    type: receive
    messages:
      - &ref_2
        id: AccountTransferExceptionMessage
        contentType: application/json
        payload:
          - name: Account Transfer Exception
            type: object
            properties:
              - name: event
                type: string
                required: true
              - name: data
                type: object
                required: true
                properties:
                  - name: event_id
                    type: string
                    description: >-
                      Unique identifier for this webhook event delivery. Use as
                      your deduplication key.
                    required: true
                  - name: event_type
                    type: string
                    description: The event type name, matching the top-level event field.
                    required: true
                  - name: event_description
                    type: string
                    description: Human-readable description of the event. Often empty.
                    required: true
                  - name: entity_id
                    type: string
                    description: Platform-assigned numeric entity identifier.
                    required: true
                  - name: entity_type
                    type: string
                    description: The type of entity associated with this event.
                    enumValues:
                      - user
                      - business
                    required: true
                  - name: account_id
                    type: string
                    description: Platform-assigned account identifier.
                    required: true
                  - name: account_type
                    type: string
                    description: Type of account (e.g. routable, virtual).
                    required: true
                  - name: transfer_id
                    type: string
                    description: Platform-assigned transfer identifier.
                    required: true
                  - name: currency
                    type: string
                    description: ISO 4217 currency code.
                    enumValues:
                      - USD
                      - usd
                    required: true
                  - name: amount
                    type: string
                    description: >-
                      Monetary amount expressed as a decimal string with two
                      decimal places.
                    required: true
                  - name: memo
                    type: string
                    description: Optional memo or description for the transfer.
                    required: false
                  - name: direction
                    type: string
                    description: Direction of fund movement from the entity's perspective.
                    enumValues:
                      - credit
                      - debit
                    required: true
                  - name: status
                    type: string
                    description: Transfer status.
                    required: true
                  - name: reference
                    type: object
                    description: >-
                      Bank-file context block present on
                      account.transfer.exception events.
                    required: true
                    properties:
                      - name: trailer
                        type: string
                        description: File trailer identifier from the bank file.
                        required: true
                      - name: control
                        type: string
                        description: Control record identifier.
                        required: true
                      - name: bank_process_date
                        type: string
                        description: Date the bank processed the file, in YYYYMMDD format.
                        required: true
                      - name: type
                        type: string
                        description: Payment rail or file type (e.g. ACH, wire).
                        required: true
                      - name: bank_timestamp
                        type: string
                        description: >-
                          Bank-assigned timestamp for the file, in
                          YYYYMMDDHHmmss format.
                        required: true
              - name: created_at
                type: string
                description: Date and time in DD-MM-YYYY hh:mm AM/PM format.
                required: true
              - name: updated_at
                type: string
                description: Date and time in DD-MM-YYYY hh:mm AM/PM format.
                required: true
        headers: []
        jsonPayloadSchema:
          type: object
          required:
            - event
            - data
            - created_at
            - updated_at
          properties:
            event:
              type: string
              example: account.transfer.exception
              x-parser-schema-id: <anonymous-schema-169>
            data:
              allOf:
                - type: object
                  required:
                    - event_id
                    - event_type
                    - event_description
                  description: >-
                    Base fields present in the data block of every Banking
                    Platform webhook event.
                  properties:
                    event_id:
                      type: string
                      pattern: ^inn_whe_[A-Za-z0-9]+$
                      description: >-
                        Unique identifier for this webhook event delivery. Use
                        as your deduplication key.
                      example: inn_whe_2tHPeibq8Gkm6kXU819g
                      x-parser-schema-id: <anonymous-schema-4>
                    event_type:
                      type: string
                      description: The event type name, matching the top-level event field.
                      x-parser-schema-id: <anonymous-schema-5>
                    event_description:
                      type: string
                      description: Human-readable description of the event. Often empty.
                      x-parser-schema-id: <anonymous-schema-6>
                  x-parser-schema-id: BankingEventDataBase
                - type: object
                  description: >-
                    Full transfer payload fields present on most
                    account.transfer.* events.
                  required:
                    - entity_id
                    - entity_type
                    - account_id
                    - account_type
                    - transfer_id
                    - currency
                    - amount
                    - direction
                    - status
                  properties:
                    entity_id:
                      type: string
                      description: Platform-assigned numeric entity identifier.
                      example: '6830'
                      x-parser-schema-id: EntityId
                    entity_type:
                      type: string
                      description: The type of entity associated with this event.
                      enum:
                        - user
                        - business
                      x-parser-schema-id: EntityType
                    account_id:
                      type: string
                      description: Platform-assigned account identifier.
                      x-parser-schema-id: <anonymous-schema-135>
                    account_type:
                      type: string
                      description: Type of account (e.g. routable, virtual).
                      example: routable
                      x-parser-schema-id: <anonymous-schema-136>
                    transfer_id:
                      type: string
                      description: Platform-assigned transfer identifier.
                      example: DPST_PVCVXAR4KRU2CTOT6026NIGGS
                      x-parser-schema-id: <anonymous-schema-137>
                    currency:
                      type: string
                      description: ISO 4217 currency code.
                      enum:
                        - USD
                        - usd
                      example: USD
                      x-parser-schema-id: Currency
                    amount:
                      type: string
                      description: >-
                        Monetary amount expressed as a decimal string with two
                        decimal places.
                      example: '500.00'
                      x-parser-schema-id: Amount
                    memo:
                      type: string
                      description: Optional memo or description for the transfer.
                      x-parser-schema-id: <anonymous-schema-138>
                    direction:
                      type: string
                      description: >-
                        Direction of fund movement from the entity's
                        perspective.
                      enum:
                        - credit
                        - debit
                      x-parser-schema-id: Direction
                    status:
                      type: string
                      description: Transfer status.
                      x-parser-schema-id: <anonymous-schema-139>
                  x-parser-schema-id: FullTransferData
                - type: object
                  required:
                    - reference
                  properties:
                    reference:
                      type: object
                      description: >-
                        Bank-file context block present on
                        account.transfer.exception events.
                      required:
                        - trailer
                        - control
                        - bank_process_date
                        - type
                        - bank_timestamp
                      properties:
                        trailer:
                          type: string
                          description: File trailer identifier from the bank file.
                          example: '0000001'
                          x-parser-schema-id: <anonymous-schema-172>
                        control:
                          type: string
                          description: Control record identifier.
                          example: CTRL001
                          x-parser-schema-id: <anonymous-schema-173>
                        bank_process_date:
                          type: string
                          description: >-
                            Date the bank processed the file, in YYYYMMDD
                            format.
                          example: '20250202'
                          x-parser-schema-id: <anonymous-schema-174>
                        type:
                          type: string
                          description: Payment rail or file type (e.g. ACH, wire).
                          example: ACH
                          x-parser-schema-id: <anonymous-schema-175>
                        bank_timestamp:
                          type: string
                          description: >-
                            Bank-assigned timestamp for the file, in
                            YYYYMMDDHHmmss format.
                          example: '20250202143000'
                          x-parser-schema-id: <anonymous-schema-176>
                      x-parser-schema-id: ExceptionReference
                  x-parser-schema-id: <anonymous-schema-171>
              x-parser-schema-id: <anonymous-schema-170>
            created_at: &ref_0
              type: string
              description: Date and time in DD-MM-YYYY hh:mm AM/PM format.
              example: 02-02-2025 06:30 PM
              x-parser-schema-id: BankingTimestamp
            updated_at: *ref_0
          x-parser-schema-id: <anonymous-schema-168>
        title: Account Transfer Exception
        example: |-
          {
            "event": "account.transfer.exception",
            "data": {
              "event_id": "inn_whe_7yPRQHRIPF91KWT364F",
              "event_type": "account.transfer.exception",
              "event_description": "",
              "entity_id": "6830",
              "entity_type": "user",
              "account_id": "6246",
              "account_type": "virtual",
              "transfer_id": "DPST_PVCVXAR4KRU2CTOT6026NIGGS",
              "currency": "USD",
              "amount": "500.00",
              "memo": "",
              "direction": "credit",
              "status": "exception",
              "reference": {
                "trailer": "0000001",
                "control": "CTRL001",
                "bank_process_date": "20250202",
                "type": "ACH",
                "bank_timestamp": "20250202143000"
              }
            },
            "created_at": "02-02-2025 06:55 PM",
            "updated_at": "02-02-2025 06:55 PM"
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: AccountTransferExceptionMessage
    bindings: []
    extensions:
      - id: x-parser-unique-object-id
        value: AccountTransferException
sendOperations:
  - *ref_1
receiveOperations: []
sendMessages:
  - *ref_2
receiveMessages: []
extensions:
  - id: x-parser-unique-object-id
    value: AccountTransferException
securitySchemes: []

````