---
title: "example_checkout_authorization_event"
method: POST
path: "/examples/checkout_authorization"
tags: ["example-checkout-events"]
---

# example_checkout_authorization_event

`POST /examples/checkout_authorization`

Event is pushed to subscribers when a transaction was authorized
or failed authorization

> The deliveries match what is delivered to the session callback_url
> with `report_error=true` set

## Headers

- `event` string, required
- `event-delivery` string, required
- `event-signature` string
- `content-type` string, required

## Request body

- CheckoutAuthorizationEvent
  - `account_id` string, required
  - `event` 'checkout_authorization', required
  - `event_delivery` string, uuid, required
  - `authorization` object, required
    - `merchant_reference` string, required — A reference by the merchant to identify the corresponding order for the Checkout Session
    - `session_id` string, required — The ID of the Checkout Session
    - `transaction_id` string — The ID of the Transaction created
    - `error` 'cancelled' | 'authorization' | 'failed'
  - `transaction` object — The transaction details, see Checkout API /api-reference/transactions/transactions_id_get for complete description of all properties that can be included in the transaction object No transaction will be included in the event if the authorization was cancelled by the user
    - `id` string, required
    - `session_id` string, required — The session id for the transaction
    - `merchant_reference` string, required — A reference specified by the merchant to identify the transaction
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `merchant_reference_2` string — A reference specified by the merchant to identify the transaction, can be updated after the transaction has been created

## Response `200`

event handled

## Other responses

- `400` — ignored, stop resend
- `500` — unhandled, resend

---

[API](https://skmtc.net/dintero/apis/account-management-api.md) · [All operations](https://skmtc.net/dintero/apis/account-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dintero/account-management-api/revisions/9b83a4199008/schema)