Skip to main content

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.

Event Name: payin_failed
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.

​
Event Payload

The webhook payload contains the following structure: 
{
  "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"
    }
  }
}