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

# Payin Failed

> Webhook event fired when a funding operation fails

<Info>
  **Event Name:** `payin_failed`
</Info>

<Note>
  This event is triggered when a funding operation fails. This can occur due to various reasons such as insufficient funds, card issues, transaction rejected by the bank, or any other error in the funding process.
</Note>

## Event Payload

The webhook payload contains the following structure:

<CodeGroup>
  ```json Example Payload - cardPayin theme={null}
  {
    "eventId": "557a1bbf-2cf1-43f3-a2c1-84042e2d669c",
    "eventType": "payin_failed",
    "timestamp": "2026-02-26T17:01:09.8266687-05:00",
    "data": {
      "status": "FAILED",
      "payinType": "cardPayin",
      "orderId": "0dac79df-8915-4dbd-9c74-d24749812629",
      "ownReference": "Merchant internal reference for reconciliation",
      "source": {
        "type": "card",
        "payer": {
          "name": "John Doe",
          "email": "john@mail.com",
          "phone": "123456789"
        }
      },
      "destination": {
        "type": "account",
        "creditedAccountId": "a5a03fd6-eacc-48ee-b8f6-67267b4095ab",
        "creditedUserId": "15c5277a-8c8c-41d2-9f42-66f82f6f113d"
      },
      "amounts": {
        "receivedAmount": {
          "amount": 3000,
          "currency": "EUR"
        }
      },
      "failure": {
        "code": "CARD_PAYIN_FAILED",
        "reason": "3ds timeout"
      }
    }
  }
  ```

  ```json Example Payload - bankPayin theme={null}
  {
    "eventId": "adbfc5ec-7e66-4ebc-995a-46247e787986",
    "eventType": "payin_failed",
    "timestamp": "2026-03-02T15:21:25.0374743-05:00",
    "data": {
      "status": "FAILED",
      "payinType": "bankPayin",
      "orderId": "3b20a613-7878-48b2-93ba-a8492a8e0ac4",
      "source": {
        "type": "bankAccount"
      },
      "destination": {
        "type": "account",
        "creditedAccountId": "a5a03fd6-eacc-48ee-b8f6-67267b4095ab",
        "creditedUserId": "15c5277a-8c8c-41d2-9f42-66f82f6f113d"
      },
      "amounts": {
        "receivedAmount": {
          "amount": 5000,
          "currency": "EUR"
        }
      },
      "failure": {
        "code": "BANK_PAYIN_FAILED",
        "reason": "Simulated bank payin failure"
      }
    }
  }
  ```

  ```json Example Payload - cryptoPayin theme={null}
  {
    "eventId": "375d1dda-4294-44e6-b0b8-8b450c9a28b0",
    "eventType": "payin_failed",
    "timestamp": "2026-03-02T15:23:18.7271515-05:00",
    "data": {
      "status": "FAILED",
      "payinType": "cryptoPayin",
      "orderId": "74f6a738-99fb-4887-af35-1cc15fca7ffc",
      "source": {
        "type": "crypto"
      },
      "destination": {
        "type": "account",
        "creditedAccountId": "a5a03fd6-eacc-48ee-b8f6-67267b4095ab",
        "creditedUserId": "15c5277a-8c8c-41d2-9f42-66f82f6f113d"
      },
      "amounts": {
        "receivedAmount": {
          "amount": 15000,
          "currency": "USDC"
        }
      },
      "failure": {
        "code": "CRYPTO_PAYIN_FAILED",
        "reason": "Simulated crypto payin failure"
      }
    }
  }
  ```
</CodeGroup>