Event Name:
payin_failedThis 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"
}
}
}
{
"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"
}
}
}
{
"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"
}
}
}