> For the complete documentation index, see [llms.txt](https://docs.omni.integratedcommerce.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omni.integratedcommerce.io/api-reference/webhook-events/transaction-events.md).

# Transaction Events

Real-time notifications for completed transaction events: `sale.completed`, `auth.completed`, `capture.completed`, `refund.completed` and `void.completed`.

Each event type is separate, so an endpoint subscribes only to the events it wants. Each event is delivered as a `POST` request whose body is a JSON payload describing the event.

Delivery, retries, endpoint configuration and signature verification are covered in the [webhooks documentation](https://fiska.gitbook.io/omni-payment-api/webhooks/webhooks) - **every delivery must have its signature verified** before it is trusted. Legacy webhooks, the delivery method every merchant has today, are verified with the `x-fsk-wh-chksm` checksum ([Verifying the checksum](https://fiska.gitbook.io/omni-payment-api/webhooks/legacy/verifying-the-checksum)). Svix webhooks, which are invite only, are verified with the `svix-*` headers ([Verifying signatures](https://fiska.gitbook.io/omni-payment-api/webhooks/svix/verifying-signatures)).

{% openapi-webhook spec="omni-api" name="SaleCompleted" method="post" %}
[omni-api](https://4401d86825a13bf607936cc3a9f3897a.r2.cloudflarestorage.com/gitbook-x-prod-openapi/raw/24ccbd1bc3d5166f03d4c48f9c95aa1eccfc72e8e825bcdb998dfa48d699b222.yaml?X-Amz-Algorithm=AWS4-HMAC-SHA256\&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD\&X-Amz-Credential=dce48141f43c0191a2ad043a6888781c%2F20260915%2Fauto%2Fs3%2Faws4_request\&X-Amz-Date=20260915T221025Z\&X-Amz-Expires=172800\&X-Amz-Signature=571743c04d846ff1a12468b40cb6903176eaa17a9c3b40512d94e1cf2c6ba140\&X-Amz-SignedHeaders=host\&x-amz-checksum-mode=ENABLED\&x-id=GetObject)
{% endopenapi-webhook %}

{% openapi-webhook spec="omni-api" name="AuthCompleted" method="post" %}
[omni-api](https://4401d86825a13bf607936cc3a9f3897a.r2.cloudflarestorage.com/gitbook-x-prod-openapi/raw/24ccbd1bc3d5166f03d4c48f9c95aa1eccfc72e8e825bcdb998dfa48d699b222.yaml?X-Amz-Algorithm=AWS4-HMAC-SHA256\&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD\&X-Amz-Credential=dce48141f43c0191a2ad043a6888781c%2F20260915%2Fauto%2Fs3%2Faws4_request\&X-Amz-Date=20260915T221025Z\&X-Amz-Expires=172800\&X-Amz-Signature=571743c04d846ff1a12468b40cb6903176eaa17a9c3b40512d94e1cf2c6ba140\&X-Amz-SignedHeaders=host\&x-amz-checksum-mode=ENABLED\&x-id=GetObject)
{% endopenapi-webhook %}

{% openapi-webhook spec="omni-api" name="CaptureCompleted" method="post" %}
[omni-api](https://4401d86825a13bf607936cc3a9f3897a.r2.cloudflarestorage.com/gitbook-x-prod-openapi/raw/24ccbd1bc3d5166f03d4c48f9c95aa1eccfc72e8e825bcdb998dfa48d699b222.yaml?X-Amz-Algorithm=AWS4-HMAC-SHA256\&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD\&X-Amz-Credential=dce48141f43c0191a2ad043a6888781c%2F20260915%2Fauto%2Fs3%2Faws4_request\&X-Amz-Date=20260915T221025Z\&X-Amz-Expires=172800\&X-Amz-Signature=571743c04d846ff1a12468b40cb6903176eaa17a9c3b40512d94e1cf2c6ba140\&X-Amz-SignedHeaders=host\&x-amz-checksum-mode=ENABLED\&x-id=GetObject)
{% endopenapi-webhook %}

{% openapi-webhook spec="omni-api" name="RefundCompleted" method="post" %}
[omni-api](https://4401d86825a13bf607936cc3a9f3897a.r2.cloudflarestorage.com/gitbook-x-prod-openapi/raw/24ccbd1bc3d5166f03d4c48f9c95aa1eccfc72e8e825bcdb998dfa48d699b222.yaml?X-Amz-Algorithm=AWS4-HMAC-SHA256\&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD\&X-Amz-Credential=dce48141f43c0191a2ad043a6888781c%2F20260915%2Fauto%2Fs3%2Faws4_request\&X-Amz-Date=20260915T221025Z\&X-Amz-Expires=172800\&X-Amz-Signature=571743c04d846ff1a12468b40cb6903176eaa17a9c3b40512d94e1cf2c6ba140\&X-Amz-SignedHeaders=host\&x-amz-checksum-mode=ENABLED\&x-id=GetObject)
{% endopenapi-webhook %}

{% openapi-webhook spec="omni-api" name="VoidCompleted" method="post" %}
[omni-api](https://4401d86825a13bf607936cc3a9f3897a.r2.cloudflarestorage.com/gitbook-x-prod-openapi/raw/24ccbd1bc3d5166f03d4c48f9c95aa1eccfc72e8e825bcdb998dfa48d699b222.yaml?X-Amz-Algorithm=AWS4-HMAC-SHA256\&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD\&X-Amz-Credential=dce48141f43c0191a2ad043a6888781c%2F20260915%2Fauto%2Fs3%2Faws4_request\&X-Amz-Date=20260915T221025Z\&X-Amz-Expires=172800\&X-Amz-Signature=571743c04d846ff1a12468b40cb6903176eaa17a9c3b40512d94e1cf2c6ba140\&X-Amz-SignedHeaders=host\&x-amz-checksum-mode=ENABLED\&x-id=GetObject)
{% endopenapi-webhook %}
