Imports
event_transaction_import_failure
The Transaction Import Failure event occurs when a transaction import (batch) file finished processing with at least one row that couldn't be processed.
Request
We send events to your webhook's URL with POST and a JSON body. Events are batched: a request can carry several events of this type. See Receiving Webhooks for batch sizes and retries, and Webhook Event Signatures to verify the request.
Headers
| Header | Description |
|---|---|
x-zinrelo-signature | The HMAC-SHA512 hex digest of <request body>:<nonce>, computed with the webhook's secret key. See Webhook Event Signatures. |
nonce | The Unix time, in milliseconds, at which the request was signed. It's part of the signed message. |
Payload
| Field | Type | Description |
|---|---|---|
request_id | string | A unique identifier of this webhook request. |
total_count | integer | The number of events in the batch (events). |
created_date | string | When the webhook request was created, as MM/DD/YYYY HH:MM:SS. |
events | array of object | The events in this batch. |
events[].id | string | The unique identifier of the event. Use it to detect events you already processed. |
events[].event_type | string | The type of event. One of event_transaction_import_failure. |
events[].data | object | The event's data. |
events[].data.file_info | object | The result of processing an import file. |
events[].data.file_info.file_name | string | The name of the imported file. |
events[].data.file_info.status | string | success when every row was imported, failure when at least one row had an error. One of success, failure. |
events[].data.file_info.total_count | integer | The number of rows in the file. |
events[].data.file_info.success_count | integer | The number of rows imported successfully. |
events[].data.file_info.error_count | integer | The number of rows that couldn't be imported. |
events[].data.file_info.inserted_count (optional) | integer | Member imports only. The number of members created. |
events[].data.file_info.updated_count (optional) | integer | Member imports only. The number of members updated. |
events[].data.file_info.erroneous_file_url (optional) | string or null | A link to a file listing the rows that couldn't be imported and why, null when there were none. |
events[].data.file_info.processed_at | string | When the file finished processing, in UTC, as MM/DD/YYYY HH:MM:SS. |
Example
{
"request_id": "6a0f2c1e4f8f0345970b6d96",
"total_count": 1,
"events": [
{
"id": "6a0f2c1e4f8f0345970b6d99",
"event_type": "event_transaction_import_failure",
"data": {
"file_info": {
"file_name": "transactions_20260101.csv",
"status": "failure",
"total_count": 250,
"success_count": 247,
"error_count": 3,
"erroneous_file_url": "https://example.com/imports/transactions_20260101_errors.csv",
"processed_at": "01/01/2026 10:15:00"
}
}
}
],
"created_date": "01/01/2026 10:15:01"
}Responses
| Status | Description |
|---|---|
200 | Acknowledges receipt of the events. Return 200 as soon as you receive the request and process the events afterwards, so the request doesn't time out. |
| Other | Any status code other than 200 is a failure: the request is sent again every 5 minutes until your endpoint returns 200 or the maximum number of attempts (5 by default) is reached. Your Customer Success Manager can change these settings. |