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.
{
"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.
{
"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.
{
"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 |
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.exempted | An authentication attempt was exempted. |
authentication.initiated
An authentication attempt is initiated.
{
"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.
{
"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.
{
"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 failed.
{
"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"
}
}
authentication.exempted
An authentication attempt was exempted.
{
"object": "event",
"webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
"event_time": "2025-07-31T11:11:36.782423Z",
"livemode": false,
"api_version": "2024-04-23",
"event_type": "authentication.exempted",
"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"
}
}
}
}
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.
{
"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).
{
"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.
{
"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
Refund scheduling, authorization, and processing failures.
| 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.
{
"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.schedule.failed
A refund was requested, but failed before sending the request to the schemes.
{
"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.
{
"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
Cancel scheduling, failures, and confirmed cancellation.
| 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.
{
"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.
{
"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.
{
"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.
{
"object": "event",
"webhook_endpoint_id": "webh_4WxqjT0YfsxXDeKPbrwRie",
"event_type": "canceled",
"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"
}
}
Balance transfer events
Sent when a balance transfer reaches a terminal state, to the owner of the transfer only. Delivery is at-least-once — deduplicate on the event_type together with the id of the balance transfer in the payload.
| event_type | Description |
|---|---|
balance_transfer.succeeded | The balance transfer settled and the funds were moved |
balance_transfer.failed | The balance transfer could not be scheduled and no funds were moved |
balance_transfer.canceled | The balance transfer was canceled before settling and no funds were moved |
balance_transfer.reversed | A settled balance transfer was reversed and the funds were moved back |
balance_transfer.succeeded
The balance transfer settled and the funds were moved.
{
"object": "event",
"webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
"event_type": "balance_transfer.succeeded",
"event_time": "2026-07-22T09:14:21.109782Z",
"livemode": false,
"api_version": "2024-04-23",
"balance_transfer": {
"id": "btr_1SiXlGx1ipmnlu4tkRA06u",
"status": "succeeded",
"account_id": "acc_SqVpnKhpr8TxS0Y7S99bI",
"amount": {
"currency": "EUR",
"quantity": "100.00"
},
"description": "Marketplace payout correction",
"created_at": "2026-07-22T09:14:20.038683Z",
"reference": "corr-2026-07-1042",
"debit": {
"id": "btrline_1SiXlGx1ipmnlu4tkRA06v",
"account_id": "acc_SqVpnKhpr8TxS0Y7S99bI",
"amount": {
"currency": "EUR",
"quantity": "-100.00"
},
"status": "succeeded",
"reference": "corr-2026-07-1042"
},
"credit": {
"id": "btrline_1SiXlGx1ipmnlu4tkRA06w",
"account_id": "acc_Xp2mnKhpr8TxS0Y7S99cJ",
"amount": {
"currency": "EUR",
"quantity": "100.00"
},
"status": "succeeded",
"reference": "corr-2026-07-1042"
}
}
}
balance_transfer.failed
The balance transfer could not be scheduled — typically because the debit account's available balance did not cover the withdrawal. No funds were moved.
{
"object": "event",
"webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
"event_type": "balance_transfer.failed",
"event_time": "2026-07-22T09:14:21.109782Z",
"livemode": false,
"api_version": "2024-04-23",
"balance_transfer": {
"id": "btr_1SiXlGx1ipmnlu4tkRA06u",
"status": "failed",
"account_id": "acc_SqVpnKhpr8TxS0Y7S99bI",
"amount": {
"currency": "EUR",
"quantity": "100.00"
},
"description": "Marketplace payout correction",
"created_at": "2026-07-22T09:14:20.038683Z",
"reference": "corr-2026-07-1042",
"debit": {
"id": "btrline_1SiXlGx1ipmnlu4tkRA06v",
"account_id": "acc_SqVpnKhpr8TxS0Y7S99bI",
"amount": {
"currency": "EUR",
"quantity": "-100.00"
},
"status": "failed",
"reference": "corr-2026-07-1042"
},
"credit": {
"id": "btrline_1SiXlGx1ipmnlu4tkRA06w",
"account_id": "acc_Xp2mnKhpr8TxS0Y7S99cJ",
"amount": {
"currency": "EUR",
"quantity": "100.00"
},
"status": "failed",
"reference": "corr-2026-07-1042"
}
}
}
balance_transfer.canceled
The balance transfer was canceled before settling. No funds were moved.
{
"object": "event",
"webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
"event_type": "balance_transfer.canceled",
"event_time": "2026-07-22T09:14:21.109782Z",
"livemode": false,
"api_version": "2024-04-23",
"balance_transfer": {
"id": "btr_1SiXlGx1ipmnlu4tkRA06u",
"status": "canceled",
"account_id": "acc_SqVpnKhpr8TxS0Y7S99bI",
"amount": {
"currency": "EUR",
"quantity": "100.00"
},
"description": "Marketplace payout correction",
"created_at": "2026-07-22T09:14:20.038683Z",
"reference": "corr-2026-07-1042",
"debit": {
"id": "btrline_1SiXlGx1ipmnlu4tkRA06v",
"account_id": "acc_SqVpnKhpr8TxS0Y7S99bI",
"amount": {
"currency": "EUR",
"quantity": "-100.00"
},
"status": "canceled",
"reference": "corr-2026-07-1042"
},
"credit": {
"id": "btrline_1SiXlGx1ipmnlu4tkRA06w",
"account_id": "acc_Xp2mnKhpr8TxS0Y7S99cJ",
"amount": {
"currency": "EUR",
"quantity": "100.00"
},
"status": "canceled",
"reference": "corr-2026-07-1042"
}
}
}
balance_transfer.reversed
A settled balance transfer was reversed and the funds were moved back.
{
"object": "event",
"webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
"event_type": "balance_transfer.reversed",
"event_time": "2026-07-22T09:14:21.109782Z",
"livemode": false,
"api_version": "2024-04-23",
"balance_transfer": {
"id": "btr_1SiXlGx1ipmnlu4tkRA06u",
"status": "reversed",
"account_id": "acc_SqVpnKhpr8TxS0Y7S99bI",
"amount": {
"currency": "EUR",
"quantity": "100.00"
},
"description": "Marketplace payout correction",
"created_at": "2026-07-22T09:14:20.038683Z",
"reference": "corr-2026-07-1042",
"debit": {
"id": "btrline_1SiXlGx1ipmnlu4tkRA06v",
"account_id": "acc_SqVpnKhpr8TxS0Y7S99bI",
"amount": {
"currency": "EUR",
"quantity": "-100.00"
},
"status": "reversed",
"reference": "corr-2026-07-1042"
},
"credit": {
"id": "btrline_1SiXlGx1ipmnlu4tkRA06w",
"account_id": "acc_Xp2mnKhpr8TxS0Y7S99cJ",
"amount": {
"currency": "EUR",
"quantity": "100.00"
},
"status": "reversed",
"reference": "corr-2026-07-1042"
}
}
}
Reports
Report creation notifications.
| event_type | Description |
|---|---|
report.created | A report was successfully created and is ready to be downloaded |
report.created
A report was successfully created and is ready to be downloaded.
{
"object": "event",
"webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
"event_time": "2025-07-31T11:11:36.782423Z",
"livemode": false,
"api_version": "2024-04-23",
"event_type": "report.created",
"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",
"start_time": "2025-07-31"
}
}
}
Company events
Company onboarding updates.
| event_type | Description |
|---|---|
company.created | A company was successfully created |
company.verification_status.updated | The verification status of a company was updated |
company.next_action.updated | The next action required for a company was updated |
company.capabilities.updated | The capabilities of a company were updated |
company.created
A company was successfully created.
{
"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",
"legal_name": "Trader Joe's",
"trade_name": "TraderJoes",
"created_at": "2024-12-24T14:18:11.422Z",
"reference": "myRefForUser1"
}
}
company.verification_status.updated
The verification status of a company was updated.
{
"object": "event",
"webhook_endpoint_id": "webh_4WxqjT0YfsxXDeKPbrwRie",
"event_type": "company.verification_status.updated",
"event_time": "2024-12-24T14:18:11.435566Z",
"livemode": false,
"api_version": "2024-04-23",
"company": {
"id": "co_5IGIrh15JJZ5oKSYubFpEr",
"object": "company",
"legal_name": "Trader Joe's",
"trade_name": "TraderJoes",
"created_at": "2024-12-24T14:18:11.422Z",
"reference": "myRefForUser1",
"verification_status": "verified",
"capabilities": {
"payments": {
"status": "allowed",
"restrictions": {}
},
"payouts": {
"status": "allowed",
"restrictions": {}
}
}
}
}
company.next_action.updated
The next action required for a company was updated.
{
"object": "event",
"webhook_endpoint_id": "webh_4WxqjT0YfsxXDeKPbrwRie",
"event_type": "company.next_action.updated",
"event_time": "2024-12-24T14:18:11.435566Z",
"livemode": false,
"api_version": "2024-04-23",
"company": {
"id": "co_5IGIrh15JJZ5oKSYubFpEr",
"object": "company",
"legal_name": "Trader Joe's",
"trade_name": "TraderJoes",
"created_at": "2024-12-24T14:18:11.422Z",
"reference": "myRefForUser1",
"verification_status": "open",
"next_action": {
"type": "provide_information",
"onboarding_url": "https://onboarding.rootline.com/..."
},
"capabilities": {
"payments": {
"status": "requested",
"restrictions": {}
},
"payouts": {
"status": "requested",
"restrictions": {}
}
}
}
}
company.capabilities.updated
The capabilities of a company were updated. Read company.capabilities to decide whether the company's accounts may take payments or receive payouts.
{
"object": "event",
"webhook_endpoint_id": "webh_4WxqjT0YfsxXDeKPbrwRie",
"event_type": "company.capabilities.updated",
"event_time": "2024-12-24T14:18:11.435566Z",
"livemode": false,
"api_version": "2024-04-23",
"company": {
"id": "co_5IGIrh15JJZ5oKSYubFpEr",
"object": "company",
"legal_name": "Trader Joe's",
"trade_name": "TraderJoes",
"created_at": "2024-12-24T14:18:11.422Z",
"reference": "myRefForUser1",
"verification_status": "open",
"capabilities": {
"payments": {
"status": "allowed_with_restrictions",
"restrictions": {
"upcoming": [
{
"type": "suspension",
"triggers": [
{
"type": "threshold",
"metric": "cumulative_payment_volume",
"amount": {
"currency": "EUR",
"quantity": "2000.00"
}
},
{
"type": "deadline",
"deadline_at": "2025-03-24T14:18:11.422Z"
}
]
}
]
}
},
"payouts": {
"status": "requested",
"restrictions": {}
}
}
}
}
Person events
Person onboarding updates.
| event_type | Description |
|---|---|
person.created | A person was successfully created |
person.created
A person object was successfully created.
{
"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 events
Account onboarding updates.
| event_type | Description |
|---|---|
account.created | An account was successfully created and is available for payments processing |
account.created
An account was successfully created and is available for payments processing.
{
"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"
}
}
Tokenization events
Payment token and customer token lifecycle updates.
| event_type | Description |
|---|---|
payment_token.created | A payment token was created. |
payment_token.updated | A payment token was updated. |
payment_token.deleted | A payment token was deleted. |
customer.created | A customer token was created. |
customer.updated | A customer token was updated. |
customer.deleted | A customer token was deleted. |
payment_token.created
A payment token was created.
{
"object": "event",
"webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
"event_time": "2025-07-31T11:11:36.782423Z",
"livemode": false,
"api_version": "2024-04-23",
"event_type": "payment_token.created",
"payment_token": {
"id": "pmttok_2kVYqS9Ds4h0e1Xv0X9jA1",
"customer_id": "cus_2kVYqS9Ds4h0e1Xv0X9jA2",
"payment_method": "visa",
"created_at": "2025-10-17T11:11:36.782423Z"
}
}
payment_token.updated
A payment token was updated.
{
"object": "event",
"webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
"event_time": "2025-07-31T11:11:36.782423Z",
"livemode": false,
"api_version": "2024-04-23",
"event_type": "payment_token.updated",
"payment_token": {
"id": "pmttok_2kVYqS9Ds4h0e1Xv0X9jA1",
"customer_id": "cus_2kVYqS9Ds4h0e1Xv0X9jA2",
"payment_method": "visa",
"created_at": "2025-10-17T11:11:36.782423Z"
}
}
payment_token.deleted
A payment token was deleted.
{
"object": "event",
"webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
"event_time": "2025-07-31T11:11:36.782423Z",
"livemode": false,
"api_version": "2024-04-23",
"event_type": "payment_token.deleted",
"payment_token": {
"id": "pmttok_2kVYqS9Ds4h0e1Xv0X9jA1",
"customer_id": "cus_2kVYqS9Ds4h0e1Xv0X9jA2",
"payment_method": "visa",
"created_at": "2025-10-17T11:11:36.782423Z"
}
}
customer.created
A customer token was created.
{
"object": "event",
"webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
"event_time": "2025-07-31T11:11:36.782423Z",
"livemode": false,
"api_version": "2024-04-23",
"event_type": "customer.created",
"customer_token": {
"id": "cus_2kVYqS9Ds4h0e1Xv0X9jA2",
"reference": "shopper-123",
"email": "jane@example.com",
"created_at": "2025-10-17T11:11:36.782423Z"
}
}
customer.updated
A customer token was updated.
{
"object": "event",
"webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
"event_time": "2025-07-31T11:11:36.782423Z",
"livemode": false,
"api_version": "2024-04-23",
"event_type": "customer.updated",
"customer_token": {
"id": "cus_2kVYqS9Ds4h0e1Xv0X9jA2",
"reference": "shopper-123",
"email": "jane@example.com",
"created_at": "2025-10-17T11:11:36.782423Z"
}
}
customer.deleted
A customer token was deleted.
{
"object": "event",
"webhook_endpoint_id": "webh_57d7INwyWDFkQ0EFq36xjQ",
"event_time": "2025-07-31T11:11:36.782423Z",
"livemode": false,
"api_version": "2024-04-23",
"event_type": "customer.deleted",
"customer_token": {
"id": "cus_2kVYqS9Ds4h0e1Xv0X9jA2",
"reference": "shopper-123",
"email": "jane@example.com",
"created_at": "2025-10-17T11:11:36.782423Z"
}
}