---
title: "POST /v2/webhook/emi"
method: POST
path: "/v2/webhook/emi"
tags: ["Webhook"]
---

# POST /v2/webhook/emi

`POST /v2/webhook/emi`

EMI webhook endpoint for receiving transaction status updates

## Headers

- `X-Request-Signature` string

## Request body

- object
  - `status` 'completed' | 'failed' — The status of the EMI operation.
  - `reason` string, nullable — The reason for the status, especially useful for failed status.
  - `amount` string — The amount of the transaction.
  - `currency` string — The currency of the transaction.
  - `orderId` string — The order ID in the EMI system.
  - `partnerPaymentId` string — The payment ID in the partner system.
  - `partnerUserId` string — The user ID in the partner system. Must match the partnerUserId of the request.
  - `requestId` string, uuid — The ID of the request in the Paybis system.
  - `bankRequisites` object — Bank account details for the transaction.
    - `bankName` string — The name of the bank.
    - `bankAddress` string — The address of the bank.
    - `accountHolderName` string — The name of the account holder.
    - `iban` string — The International Bank Account Number.
    - `swift` string — The SWIFT/BIC code of the bank.

## Response `204`

Webhook received and processed successfully.

## Other responses

- `400` — Bad request exception
- `401` — API key is missing
- `403` — Invalid API key or access disabled
- `404` — Request not found
- `409` — Conflict
- `422` — Validation error
- `503` — Maintenance status

---

[API](https://skmtc.dev/payb/apis/widget.md) · [All operations](https://skmtc.dev/payb/apis/widget/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/payb/widget/revisions/2c2cf39656c5/schema)