> ## 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.

# Wallet Top-Up Failed

> Fired when a wallet top-up fails. transaction_id, currency, and amount may be empty if the failure occurred before those values were resolved.



## AsyncAPI

````yaml specs/asyncapi-banking.yaml WalletTopupFailed
id: WalletTopupFailed
title: Wallet Top-Up Failed
description: >-
  Fired when a wallet top-up fails. transaction_id, currency, and amount may be
  empty if the failure occurred before those values were resolved.
servers:
  - id: webhook
    protocol: https
    host: your-webhook-endpoint.example.com
    bindings: []
    variables: []
address: wallet.topup.failed
parameters: []
bindings: []
operations:
  - &ref_1
    id: receiveWalletTopupFailed
    title: Receive wallet topup failed
    description: Wallet Top-Up Failed
    type: receive
    messages:
      - &ref_2
        id: WalletTopupFailedMessage
        contentType: application/json
        payload:
          - name: Wallet Top-Up Failed
            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: wallet_id
                    type: string
                    description: Platform-assigned wallet identifier.
                    required: true
                  - name: transaction_id
                    type: string
                    description: >-
                      Platform-assigned transaction identifier. May be empty if
                      the failure occurred before a transaction was created.
                    required: false
                  - name: currency
                    type: string
                    description: >-
                      ISO 4217 currency code. May be empty if the failure
                      occurred before currency was resolved.
                    required: false
                  - name: amount
                    type: string
                    description: >-
                      Transaction amount. May be empty if the failure occurred
                      before amount was resolved.
                    required: false
              - 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: wallet.topup.failed
              x-parser-schema-id: <anonymous-schema-59>
            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
                  required:
                    - entity_id
                    - entity_type
                    - wallet_id
                  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
                    wallet_id:
                      type: string
                      description: Platform-assigned wallet identifier.
                      x-parser-schema-id: <anonymous-schema-62>
                    transaction_id:
                      type: string
                      nullable: true
                      description: >-
                        Platform-assigned transaction identifier. May be empty
                        if the failure occurred before a transaction was
                        created.
                      x-parser-schema-id: <anonymous-schema-63>
                    currency:
                      type: string
                      description: >-
                        ISO 4217 currency code. May be empty if the failure
                        occurred before currency was resolved.
                      x-parser-schema-id: <anonymous-schema-64>
                    amount:
                      type: string
                      description: >-
                        Transaction amount. May be empty if the failure occurred
                        before amount was resolved.
                      x-parser-schema-id: <anonymous-schema-65>
                  x-parser-schema-id: <anonymous-schema-61>
              x-parser-schema-id: <anonymous-schema-60>
            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-58>
        title: Wallet Top-Up Failed
        example: |-
          {
            "event": "wallet.topup.failed",
            "data": {
              "event_id": "inn_whe_0hYAzqAr6Osw4tFC697o",
              "event_type": "wallet.topup.failed",
              "event_description": "",
              "entity_id": "9414",
              "entity_type": "user",
              "wallet_id": "2201",
              "transaction_id": "",
              "currency": "",
              "amount": ""
            },
            "created_at": "24-06-2025 10:05 AM",
            "updated_at": "24-06-2025 10:05 AM"
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: WalletTopupFailedMessage
    bindings: []
    extensions:
      - id: x-parser-unique-object-id
        value: WalletTopupFailed
sendOperations:
  - *ref_1
receiveOperations: []
sendMessages:
  - *ref_2
receiveMessages: []
extensions:
  - id: x-parser-unique-object-id
    value: WalletTopupFailed
securitySchemes: []

````