Webhook events

Webhook events can be used to keep your system in sync with Rootline's system. For checkout related events, such as payment.succeeded we advise not to solely rely on the webhook events, but to use our GET /payments to retrieve the result of the payment.

Good to know: Rootline creates a payment object for each split payment. An event on a root payment, therefore, triggers (webhook) events for downstream split payments as well, unless the accounts that payments are split to are disabled from the webhook configuration.

If you wish to receive events for just your platform account, you can amend the webhook configuration in the dashboard.

Payment events

Payment events give you the information you need to be informed about the result of the checkout process, and about an update on a payment (if applicable). Update on payments are currently only sent when you updated platform fees or a reference, after the payment was created.

event_type	Description
`payment.succeeded`	Your payment was successfully authorized
`payment.failed`	The payment failed. The authorization was declined or had an error
`payment.updated`	The payment was updated, for instance after adding or updating fees

payment.succeeded

Your payment was successfully authorized.

Example of a payment.succeeded event
{
    "object": "event",
    "webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
    "event_type": "payment.succeeded",
    "event_time": "2025-07-31T11:11:36.782423Z",
    "livemode": false,
    "api_version": "2024-04-23",
    "payment": {
        "id": "pmt_11TFvlPEnlczJo2ZsH00KO",
        "object": "payment",
        "created_at": "2025-07-31T11:10:41.851365Z",
        "account_id": "acc_16O7tapTkKddMRpEB7o0vc",
        "reference": "your payment",
        "amount": {
            "currency": "EUR",
            "quantity": "0.08"
        },
        "payment_rails": {
            "payment_method": "ideal"
        },
        "checkout_status": "succeeded",
        "return_url": "https://rootline.com/",
        "description": "Test description",
        "splits": [
            {
                "account_id": "acc_SqVpnKhpr8TxS0Y7S99bI",
                "amount": {
                    "currency": "EUR",
                    "quantity": "0.08"
                },
                "reference": "payment-reference-1",
                "id": "pmt_11TFvlPEnlczJo2ZsH00KP",
                "fees": [
                    {
                        "flat_rate": {
                            "amount": {
                                "currency": "EUR",
                                "quantity": "0.02"
                            }
                        },
                        "id": "fee_11TFvlPEnlczJo2ZsH00KQ",
                        "fee_type": "platform_fee",
                        "reference": "fee-reference-1"
                    }
                ],
                "release_funds_at": "2025-08-23T18:44:27.287193Z"
            }
        ],
        "statement_descriptor": "Apparel jeans",
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36"
    }
}

payment.failed

The payment failed. The authorization was declined or had an error.

Example of a payment.failed event
{
    "object": "event",
    "webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
    "event_type": "payment.failed",
    "event_time": "2025-08-06T12:27:33.358235Z",
    "livemode": false,
    "api_version": "2024-04-23",
    "payment": {
        "id": "pmt_4AWSixpDx7WbHm10ymQp8K",
        "object": "payment",
        "created_at": "2025-08-06T12:24:15.403907Z",
        "account_id": "acc_16O7tapTkKddMRpEB7o0vc",
        "reference": "your payment",
        "amount": {
            "currency": "EUR",
            "quantity": "0.08"
        },
        "payment_rails": {
            "payment_method": "ideal"
        },
        "checkout_status": "failed",
        "return_url": "https://rootline.com/",
        "description": "Test description",
        "splits": [
            {
                "account_id": "acc_SqVpnKhpr8TxS0Y7S99bI",
                "amount": {
                    "currency": "EUR",
                    "quantity": "0.08"
                },
                "reference": "payment-reference-1",
                "id": "pmt_4AWSixpDx7WbHm10ymQp8L",
                "fees": [
                    {
                        "flat_rate": {
                            "amount": {
                                "currency": "EUR",
                                "quantity": "0.02"
                            }
                        },
                        "id": "fee_4AWSixpDx7WbHm10ymQp8M",
                        "fee_type": "platform_fee",
                        "reference": "fee-reference-1"
                    }
                ],
                "release_funds_at": "2025-07-23T18:44:27.287193Z"
            }
        ],
        "statement_descriptor": "Apparel jeans",
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36"
    }
}

payment.updated

The payment was updated, for instance after adding or updating fees. The webhook content returns the state of the payment after the update is processed.

Example of a payment.updated event
{
    "object": "event",
    "webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
    "event_type": "payment.updated",
    "event_time": "2025-07-31T12:13:29.897720Z",
    "livemode": false,
    "api_version": "2024-04-23",
    "payment": {
        "id": "pmt_1SiXlGx1ipmnlu4tkRA06i",
        "object": "payment",
        "created_at": "2025-07-31T11:24:07.472683Z",
        "account_id": "acc_16O7tapTkKddMRpEB7o0vc",
        "reference": "root-payment-reference",
        "amount": {
            "currency": "EUR",
            "quantity": "100.10"
        },
        "payment_rails": {
            "payment_method": "ideal"
        },
        "checkout_status": "succeeded",
        "return_url": "https://rootline.com",
        "description": "Charge fees",
        "splits": [
            {
                "account_id": "acc_SqVpnKhpr8TxS0Y7S99bI",
                "amount": {
                    "currency": "EUR",
                    "quantity": "100.10"
                },
                "reference": "payment-reference-1",
                "id": "pmt_1SiXlGx1ipmnlu4tkRA06j",
                "fees": [
                    {
                        "flat_rate": {
                            "amount": {
                                "currency": "EUR",
                                "quantity": "1.88"
                            }
                        },
                        "id": "fee_1SiXlGx1ipmnlu4tkRA06k",
                        "fee_type": "platform_fee",
                        "reference": "fee-reference-1"
                    },
                    {
                        "flat_rate": {
                            "amount": {
                                "currency": "EUR",
                                "quantity": "1.80"
                            }
                        },
                        "id": "fee_1SiXlGx1ipmnlu4tkRA06s",
                        "fee_type": "platform_fee"
                    }
                ],
                "release_funds_at": "2025-08-19T08:44:27.287193Z"
            }
        ],
        "statement_descriptor": "Platform name",
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36"
    }
}

Authorization events

Authorization events give you detailed information on authorization attempts.

event_type	Description
`authorization.approved`	The authorization attempt was approved
`authorization.declined`	The authorization attempt was declined
`authorization.error`	The authorization attempt had an error

authorization.approved

The authorization attempt was approved.

Example of an authorization.approved event
{
    "object": "event",
    "webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
    "event_type": "authorization.approved",
    "event_time": "2025-07-31T11:24:27.717159Z",
    "livemode": false,
    "api_version": "2024-04-23",
    "authorization": {
        "id": "auth_1SiXlGx1ipmnlu4tkRA06n",
        "object": "authorization",
        "created_at": "2025-07-31T11:24:25.982658Z",
        "amount": {
            "currency": "EUR",
            "quantity": "100.10"
        },
        "payment_rails": {
            "payment_method": "ideal"
        },
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36"
    }
}

authorization.declined

The authorization attempt was declined.

Example of an authorization.declined event
{
    "object": "event",
    "webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
    "event_type": "authorization.declined",
    "event_time": "2025-08-06T12:27:33.337215Z",
    "livemode": false,
    "api_version": "2024-04-23",
    "authorization": {
        "id": "auth_4AWSixpDx7WbHm10ymQp8P",
        "object": "authorization",
        "created_at": "2025-08-06T12:27:21.373520Z",
        "amount": {
            "currency": "EUR",
            "quantity": "0.08"
        },
        "decline_details": {
            "code": "refused",
            "provider_response_code": "Declined",
            "provider_response_message": "Declined"
        },
        "payment_rails": {
            "payment_method": "ideal"
        },
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36"
    }
}

authorization.error

The authorization attempt had an error.

Example of an authorization.error event
{
    "object": "event",
    "webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
    "event_type": "authorization.error",
    "event_time": "2025-08-06T12:33:30.215765Z",
    "livemode": false,
    "api_version": "2024-04-23",
    "authorization": {
        "id": "auth_11SL02chVOTA7Mgt5V01KQ",
        "object": "authorization",
        "created_at": "2025-08-06T12:33:17.495559Z",
        "amount": {
            "currency": "EUR",
            "quantity": "0.08"
        },
        "decline_details": {
            "code": "error",
            "provider_response_code": "Error",
            "provider_response_message": "Error"
        },
        "payment_rails": {
            "payment_method": "ideal"
        },
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36"
    }
}

Authentication events

Authentication events give you detailed information about the authentication process, if applicable, such as Strong Customer Authentication for cards, also known as 3D secure.

event_type	Description
`authentication.initiated`	An authentication attempt is initiated
`authentication.pending`	An authentication attempt is pending. There is no final result yet
`authentication.authenticated`	An authentication attempt is successfully completed
`authentication.failed`	An authentication attempt failed

authentication.initiated

An authentication attempt is initiated.

Example of an authentication.initiated event
{
    "object": "event",
    "webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
    "event_type": "authentication.initiated",
    "event_time": "2025-08-07T11:53:11.953051Z",
    "livemode": false,
    "api_version": "2024-04-23",
    "authentication": {
        "id": "authn_4BTMK88AceqmsAqXBOAR6M",
        "object": "authentication",
        "created_at": "2025-08-07T11:53:11.919205Z",
        "amount": {
            "currency": "EUR",
            "quantity": "0.08"
        },
        "payment_rails": {
            "payment_method": "visa",
            "card_summary": {
                "bin": "400665",
                "last_four_digits": "4578",
                "funding_type": "debit",
                "card_category": "consumer",
                "regionalities": [
                    "domestic"
                ],
                "issuing_country_code": "NL"
            }
        },
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36"
    }
}

authentication.pending

An authentication attempt is pending.

Example of an authentication.pending event
{
    "object": "event",
    "webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
    "event_type": "authentication.pending",
    "event_time": "2025-08-12T09:32:40.409072Z",
    "livemode": false,
    "api_version": "2024-04-23",
    "authentication": {
        "id": "authn_1UaS9eW9TZNi4bpDovby8z",
        "object": "authentication",
        "created_at": "2025-08-12T09:32:40.367830Z",
        "amount": {
            "currency": "EUR",
            "quantity": "0.08"
        },
        "payment_rails": {
            "payment_method": "visa",
            "card_summary": {
                "bin": "467518",
                "last_four_digits": "9213",
                "funding_type": "credit",
                "card_category": "commercial",
                "regionalities": [
                    "domestic"
                ],
                "issuing_country_code": "NL"
            }
        },
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36"
    }
}

authentication.authenticated

An authentication attempt is successfully authenticated.

Example of an authentication.authenticated event
{
    "object": "event",
    "webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
    "event_type": "authentication.authenticated",
    "event_time": "2025-08-07T11:53:11.960193Z",
    "livemode": false,
    "api_version": "2024-04-23",
    "authentication": {
        "id": "authn_4BTMK88AceqmsAqXBOAR6L",
        "object": "authentication",
        "created_at": "2025-08-07T11:53:11.919205Z",
        "amount": {
            "currency": "EUR",
            "quantity": "0.08"
        },
        "payment_rails": {
            "payment_method": "visa",
            "card_summary": {
                "bin": "400665",
                "last_four_digits": "4578",
                "funding_type": "debit",
                "card_category": "consumer",
                "regionalities": [
                    "domestic"
                ],
                "issuing_country_code": "NL"
            }
        },
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36"
    }
}

authentication.failed

An authentication attempt is successfully authenticated.

Example of an authentication.failed event
{
    "object": "event",
    "webhook_endpoint_id": "webh_5SNJfSeG7TCBLO1yUG3hQv",
    "event_type": "authentication.failed",
    "event_time": "2025-08-18T08:23:38.144138Z",
    "livemode": false,
    "api_version": "2024-04-23",
    "authentication": {
        "id": "authn_5OI9YojcOk8J24k5lNSipB",
        "object": "authentication",
        "created_at": "2025-08-18T08:23:35.526921Z",
        "amount": {
            "currency": "EUR",
            "quantity": "0.08"
        },
        "decline_details": {
            "code": "error",
            "provider_response_code": "01",
            "provider_response_message": "Card authentication failed."
        },
        "payment_rails": {
            "payment_method": "mastercard",
            "card_summary": {
                "bin": "550720",
                "last_four_digits": "6478",
                "funding_type": "credit",
                "card_category": "commercial",
                "regionalities": [
                    "domestic"
                ],
                "issuing_country_code": "NL"
            }
        },
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36"
    }
}

Capture events

If automatic captures are enabled on your account, it not necessary to subscribe to the scheduled event types.

event_type	Description
`capture.scheduled`	A capture was successfully created and scheduled for submission to the network
`capture.schedule.failed`	A capture was requested, but failed before sending the request to the schemes
`capture.failed`	A capture failed when attempted to be processed by the acquirer

capture.scheduled

A capture was successfully created and scheduled for submission to the network.

Example of a capture.scheduled event
{
    "object": "event",
    "webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
    "event_type": "capture.scheduled",
    "event_time": "2025-07-31T11:24:27.717159Z",
    "livemode": false,
    "api_version": "2024-04-23",
    "capture": {
        "id": "cap_1SiXlGx1ipmnlu4tkRA08M",
        "object": "capture",
        "account_id": "acc_SqVpnKhpr8TxS0Y7S99bI",
        "transaction_time": "2025-07-31T11:24:28.144584Z",
        "description": "payment-reference-1",
        "amount": {
            "currency": "EUR",
            "quantity": "100.10"
        },
        "authorization_id": "auth_1SiXlGx1ipmnlu4tkRA06o",
        "payment_id": "pmt_1SiXlGx1ipmnlu4tkRA06j"
    }
}

capture.schedule.failed

A capture was requested, but failed before sending the request to the schemes. This could happen for instance because the payment did not have sufficient balance to capture (any more).

Example of a capture.schedule.failed event
{
    "object": "event",
    "webhook_endpoint_id": "webh_7Swjmu6foX7Os8Y1ejdlHZ",
    "event_type": "capture.schedule.failed",
    "event_time": "2025-07-28T16:53:25.140736Z",
    "livemode": false,
    "api_version": "2024-04-23",
    "failed_event": {
        "payment_id": "pmt_1Wb04zokJ4l2gQ4sOZCgKm",
        "failed_event_id": "cap_1Wb04zokJ4l2gQ4sOZCgL0",
        "failure_details": {
            "code": "insufficient_balance",
            "message": "Insufficient Authorization Balance"
        }
    }
}

capture.failed

A capture failed when attempted to be processed by the acquirer.

Example of a capture.failed event
{
    "object": "event",
    "webhook_endpoint_id": "webh_7Swjmu6foX7Os8Y1ejdlHZ",
    "event_type": "capture.failed",
    "event_time": "2025-07-28T16:48:46.475188Z",
    "livemode": false,
    "api_version": "2024-04-23",
    "capture": {
        "id": "cap_1TpqkGVhJl0d9j4UZejvOX",
        "object": "capture",
        "account_id": "acc_5DiujgIChvJPFbFbHBqHYz",
        "transaction_time": "2025-07-28T16:48:42.081734Z",
        "description": "test_capture_declined",
        "amount": {
            "currency": "EUR",
            "quantity": "10.00"
        },
        "authorization_id": "auth_1TpqkGVhJl0d9j4UZejvOT",
        "payment_id": "pmt_1TpqkGVhJl0d9j4UZejvOK"
    }
}

Refund events

event_type	Description
`refund.scheduled`	A refund was successfully created and scheduled for submission to the network
`refund.authorized`	A refund request was authorized by the issuing bank
`refund.schedule.failed`	A refund was requested, but failed before sending the request to the schemes
`refund.failed`	A refund was sent to the network, but in the process it failed

refund.scheduled

A refund was successfully created and scheduled for submission to the network.

Example of a refund.scheduled event
{
    "object": "event",
    "webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
    "event_type": "refund.scheduled",
    "event_time": "2025-07-31T12:33:53.109782Z",
    "livemode": false,
    "api_version": "2024-04-23",
    "refund":
    {
        "id": "ref_1SiXlGx1ipmnlu4tkRA06u",
        "object": "refund",
        "account_id": "acc_SqVpnKhpr8TxS0Y7S99bI",
        "transaction_time": "2025-07-31T12:33:54.038683Z",
        "description": "TestReference",
        "amount":
        {
            "currency": "EUR",
            "quantity": "100.10"
        },
        "authorization_id": "auth_1SiXlGx1ipmnlu4tkRA06o",
        "payment_id": "pmt_1SiXlGx1ipmnlu4tkRA06j"
    }
}

refund.authorized

A refund request was authorized by the issuing bank.

Example of a refund.authorized event
{
  "object": "event",
  "webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
  "event_type": "refund.authorized",
  "event_time": "2025-08-14T13:15:57.251314Z",
  "livemode": false,
  "api_version": "2024-04-23",
  "refund_authorization": {
    "id": "refauth_HET5Lu2TozO7mznOIAYcP",
    "object": "refund_authorization",
    "account_id": "acc_SqVpnKhpr8TxS0Y7S99bI",
    "transaction_time": "2025-08-14T13:15:57.358348Z",
    "description": "TestReference",
    "amount": {
      "currency": "EUR",
      "quantity": "100.10"
    },
    "authorization_id": "auth_HET5Lu2TozO7mznOIAYar",
    "payment_id": "pmt_HET5Lu2TozO7mznOIA36m"
  }
}

refund.schedule.failed

A refund was requested, but failed before sending the request to the schemes.

Example of a refund.schedule.failed event
{
  "object": "event",
  "webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
  "event_type": "refund.schedule.failed",
  "event_time": "2025-08-07T11:57:48.754771Z",
  "livemode": false,
  "api_version": "2024-04-23",
  "failed_event": {
    "payment_id": "pmt_4BTMK88AceqmsAqXBOAR6G",
    "failed_event_id": "ref_4BTMK88AceqmsAqXBOAR6U",
    "failure_details": {
      "code": "insufficient_balance",
      "message": "Insufficient Authorization Balance"
    }
  }
}

refund.failed

A refund was sent to the network, but in the process it failed.

Example of a refund.failed event
{
    "object": "event",
    "webhook_endpoint_id": "webh_1LRC9rQ61Wy6pDMuiwz74u",
    "event_type": "refund.failed",
    "event_time": "2025-08-18T13:13:07.932920Z",
    "livemode": false,
    "api_version": "2024-04-23",
    "refund":
    {
        "id": "ref_4gyN3vuJlc5pP9heMBOR3x",
        "object": "refund",
        "account_id": "acc_1Ge9bE7LDv73HLQiJtRHws",
        "transaction_time": "2025-08-18T13:13:06.868171Z",
        "description": "test_refund_declined",
        "amount":
        {
            "currency": "EUR",
            "quantity": "300.00"
        },
        "authorization_id": "auth_4gyN3vuJlc5pP9heMBOR3q",
        "payment_id": "pmt_4gyN3vuJlc5pP9heMBOR3g"
    }
}

Cancel events

event_type	Description
`cancel.scheduled`	A cancel was successfully created and scheduled for submission to the network
`cancel.schedule.failed`	A cancel request was done, but failed before sending the request to the schemes
`cancel.failed`	A cancel was sent to the network, but in the process it failed
`canceled`	The cancel request is confirmed with success

cancel.scheduled

A cancel was successfully created and scheduled for submission to the network.

Example of a cancel.scheduled event
{
  "object": "event",
  "webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
  "event_type": "cancel.scheduled",
  "event_time": "2025-08-07T11:47:40.265610Z",
  "livemode": false,
  "api_version": "2024-04-23",
  "cancel": {
    "id": "can_WG47jr4YsSjMh3LoBK7UT",
    "object": "cancel",
    "account_id": "acc_16O7tapTkKddMRpEB7o0vc",
    "transaction_time": "2025-08-07T11:47:41.169096Z",
    "description": "cancel-reference",
    "amount": {
      "currency": "EUR",
      "quantity": "0.08"
    },
    "authorization_id": "auth_WG47jr4YsSjMh3LoBK7UP",
    "payment_id": "pmt_WG47jr4YsSjMh3LoBK7UG"
  }
}

cancel.schedule.failed

A cancel request was done, but failed before sending the request to the schemes.

Example of a cancel.schedule.failed event
{
  "object": "event",
  "webhook_endpoint_id": "webh_5SNJfSeG7TCBLO1yUG3hQv",
  "event_type": "cancel.schedule.failed",
  "event_time": "2025-08-14T15:05:53.343328Z",
  "livemode": false,
  "api_version": "2024-04-23",
  "failed_event": {
    "payment_id": "pmt_FWuCkAijFuuW3F4C0k2E4",
    "failed_event_id": "can_FWuCkAijFuuW3F4C0k2ED",
    "failure_details": {
      "code": "insufficient_balance",
      "message": "Insufficient Authorization Balance"
    }
  }
}

cancel.failed

A cancel was sent to the network, but in the process it failed.

Example of a cancel.failed event
{
    "object": "event",
    "webhook_endpoint_id": "webh_4WxqjT0YfsxXDeKPbrwRie",
    "event_type": "cancel.failed",
    "event_time": "2025-08-18T13:21:53.168176Z",
    "livemode": false,
    "api_version": "2024-04-23",
    "cancel": {
        "id": "can_5R11iZq70sMKiJzBNCLyqD",
        "object": "cancel",
        "account_id": "acc_16O7tapTkKddMRpEB7o0vc",
        "transaction_time": "2025-08-18T13:21:52.888409Z",
        "description": "test_cancel_declined",
        "amount": {
            "currency": "EUR",
            "quantity": "0.08"
        },
        "authorization_id": "auth_5R11iZq70sMKiJzBNCLyq9",
        "payment_id": "pmt_5R11iZq70sMKiJzBNCLyq0"
    }
}

canceled

The cancel request is confirmed with success.

Example of a canceled event
{
    "object": "event",
    "webhook_endpoint_id": "webh_4WxqjT0YfsxXDeKPbrwRie",
    "event_type": "cancel.failed",
    "event_time": "2025-08-18T13:21:53.168176Z",
    "livemode": false,
    "api_version": "2024-04-23",
    "cancel": {
        "id": "can_5R11iZq70sMKiJzBNCLyqD",
        "object": "cancel",
        "account_id": "acc_16O7tapTkKddMRpEB7o0vc",
        "transaction_time": "2025-08-18T13:21:52.888409Z",
        "description": "test_cancel_declined",
        "amount": {
            "currency": "EUR",
            "quantity": "0.08"
        },
        "authorization_id": "auth_5R11iZq70sMKiJzBNCLyq9",
        "payment_id": "pmt_5R11iZq70sMKiJzBNCLyq0"
    }
}

Reports

event_type	Description
`report.created`	A report was successfully created and is ready to be downloaded

report.available

A report was successfully created and is ready to be downloaded.

Example of a report.available event
{
  "object": "event",
  "webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
  "event_type": "report.created",
  "event_time": "2025-08-01T09:20:52.866397Z",
  "livemode": false,
  "api_version": "2024-04-23",
  "report": {
    "id": "report_4xvGyr7lyx2SM3JOKxF2ez",
    "object": "report",
    "report_type": "settlement_report",
    "file_name": "SettlementReport_2025-08-01T09:18:17.249Z_report_4xvGyr7lyx2SM3JOKxF2ez.csv",
    "generated_at": "2025-08-01T09:18:17.249Z",
    "download_url": "https://report-api.staging.rootline.com/v1/reports/report_4xvGyr7lyx2SM3JOKxF2ez/download",
    "sha256": "PJpOdy2KyLq2ehx79/3k+A7LFFaICMuOjcPIFzlfQng=",
    "version": "2024-04-23",
    "input_parameters": {
      "end_time": "2025-07-31",
      "account_id": "acc_SqVpnKhpr8TxS0Y7S99bI",
      "short_edit": "true",
      "start_time": "2025-07-31"
    }
  }
}

Account activation

event_type	Description
`company.created`	A company was successfully created
`person.created`	A person was successfully created
`account.created`	An account was successfully created and is available for payments processing

company.created

A company was successfully created.

Example of a company.created event
{
    "object": "event",
    "webhook_endpoint_id": "webh_4WxqjT0YfsxXDeKPbrwRie",
    "event_type": "company.created",
    "event_time": "2024-12-24T14:18:11.435566Z",  
    "livemode": false,
    "api_version": "2024-04-23",
    "company": {
        "id": "co_5IGIrh15JJZ5oKSYubFpEr",
        "object": "company",
        "name": "TraderJoes",
        "company_name": "Trader Joe's",
        "created_at": "2024-12-24T14:18:11.422Z",
        "reference": "myRefForUser1"
    }
}

person.created

A person object was successfully created.

Example of a person.created event
{
    "object": "event",
    "webhook_endpoint_id": "webh_4WxqjT0YfsxXDeKPbrwRie",
    "event_type": "person.created",
    "event_time": "2024-12-24T14:18:11.435566Z",  
    "livemode": false,
    "api_version": "2024-04-23",
    "person": {
        "id": "pers_5IGIrh15JJZ5oKSYubFpEr",
        "object": "person",
        "name": "JoeDoe",
        "first_name": "Trader Joe's",
        "last_name": "Trader Joe's",
        "created_at": "2024-12-24T14:18:11.422Z",
        "reference": "myRefForUser1"
    }
}

account.created

An account was successfully created and is available for payments processing.

Example of a account.created event
{
    "object": "event",
    "webhook_endpoint_id": "webh_59rz4zUN69BvGY8cpo7lqn",
    "event_type": "account.created",
    "event_time": "2024-12-24T14:21:34.914319Z",  
    "livemode": false,
    "api_version": "2024-04-23",
    "account": {
        "id": "acc_47fm2EUbd8ndPcMu5ULmcA",
        "object": "account",
        "description": "Trader Joe's account",
        "name": "simplythetest",
        "legal_entity_id": "co_5IGIrh15JJZ5oKSYubFpEr",
        "base_return_url": "https://www.tradingjoes.com",
        "created_at": "2024-12-24T14:21:34.881Z",
        "reference": "myRefForUser1"
    }
}

Payment events​

payment.succeeded​

payment.failed​

payment.updated​

Authorization events​

authorization.approved​

authorization.declined​

authorization.error​

Authentication events​

authentication.initiated​

authentication.pending​

authentication.authenticated​

authentication.failed​

Capture events​

capture.scheduled​

capture.schedule.failed​

capture.failed​

Refund events​

refund.scheduled​

refund.authorized​

refund.schedule.failed​

refund.failed​

Cancel events​

cancel.scheduled​

cancel.schedule.failed​

cancel.failed​

canceled​

Reports​

report.available​

Account activation​

company.created​

person.created​

account.created​