---
title: "Handles event notifications sent by the PXP system."
method: POST
path: "/events"
---

# Handles event notifications sent by the PXP system.

`POST /events`

Handles event notifications sent by the PXP system.

## Request body

- object — Envelope for different types of events. The 'data' property contains the properties for the specified event type.
  - `id` string, required — The unique identifier of the event. Can be used for tracking which events have been already processed.
  - `createdOn` string, required — The UTC date and time when the event was sent. Used for identifying the correct order of events.
  - `type` 'MerchantStateChangedEvent' | 'PreScreenMerchantStateChangedEvent', required — The type of the event. Used for specifying what properties will be put in the 'data' property.
  - `data` object, required — Contains the specific event data. Only one of the following properties must be sent, matching the event type.
    - `merchantStateChangedEvent` object — Indicates that a merchant's state has been changed. Contains the data of the new state.
      - `merchantId` string, required — The unique identifier of the merchant, which was received in the merchant registration response.
      - `state` object, required — The new state of the merchant. See https://developer.kalixa.com/docs/merchant-onboarding-notifications for additional information about states and state reasons.
        - `type` 'Declined' | 'PendingOnPreScreeningData' | 'PendingOnUnderwritingData' | 'PendingOnDocuments' | 'PendingOnContract' | 'PendingOnActivation' | 'Active' | 'ConditionallyActive' | 'Blocked' | 'Closed', required — The name of the state.
        - `reason` string — Additional details about the state. Applicable only for some states. See https://developer.kalixa.com/docs/merchant-onboarding-notifications for additional information about states and state reasons.
      - `cardPresentMid` string — The merchant identifier to be used in payment initiations for a card present (CP/POS) shop. See https://developer.kalixa.com/v1.0/docs/conditionally-mandatory-parameters for more information about submitting card payments for POS (CP) merchants.
    - `preScreenMerchantStateChangedEvent` object — Indicates that a prescreen-merchant's state has been changed. Contains the data of the new state.
      - `preScreenMerchantId` string, required — The unique identifier of the prescreen-merchant, which was received in the prescreen-merchant registration response.
      - `state` object, required — The new state of the prescreen-merchant. See https://developer.kalixa.com/docs/merchant-onboarding-notifications for additional information about states and state reasons.
        - `type` 'Approved' | 'Declined' | 'Pending', required — The name of the state.

## Response `200`

Event successfully received by the subscriber.

## Other responses

- `400` — The subscriber could not process the event. The event will not be re-sent again.
- `500` — Technical error occurred, the event will be sent again.

---

[API](https://skmtc.net/kalixa/apis/payment-service-v3.md) · [All operations](https://skmtc.net/kalixa/apis/payment-service-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kalixa/payment-service-v3/revisions/0efbe1f72b35/schema)