naftiko: 1.0.0-alpha2
info:
  label: Kushki Webhooks — Events
  description: 'Kushki Webhooks — Events. Receiver-side capability describing the JSON event payload Kushki delivers to merchant-configured webhook URLs. Configuration of the webhook URL itself is performed in the Kushki Console; this capability documents the inbound shape.'
  tags:
    - Kushki
    - Webhooks
    - Events
    - Notifications
  created: '2026-05-24'
  modified: '2026-05-24'
binds: []
capability:
  exposes:
    - type: rest
      namespace: webhooks-events-receiver
      port: 8080
      description: REST receiver for inbound Kushki webhook events.
      resources:
        - path: /v1/webhooks/kushki
          name: kushki-webhook-receiver
          description: Endpoint to which Kushki POSTs JSON event payloads.
          operations:
            - method: POST
              name: receivewebhook
              description: Receive a Kushki webhook event (approved, declined, voided, refunded, captured, transfer settled, cash voucher paid, payout completed, subscription charged).
              inputParameters:
                - name: body
                  in: body
                  type: object
                  description: 'Kushki webhook event. Keys include: transactionStatus, ticketNumber, merchantId, currencyCode, amount, paymentBrand, transactionReference, transactionType, eventType, country.'
                  required: true
              outputParameters:
                - type: object
                  mapping: $.