---
title: "Receive Webhook Event"
method: POST
path: "/webhooks"
tags: ["SETUP"]
---

# Receive Webhook Event

`POST /webhooks`

Receives and processes event notifications from third-party services.

## Headers

- `api-key` string
- `api-secret` string

## Request body

- WebhookEventDto
  - `referenceId` string, uuid, required — Unique reference identifier (UUID) for the transaction or entity
  - `eventType` 'KYC' | 'ONRAMP' | 'OFFRAMP' | 'KYB', required — Type of event being processed
  - `status` string, required — Current status of the event or transaction
  - `metadata` object — Additional metadata or provider-specific information

## Response `201`

---

[API](https://skmtc.net/alfredpay/apis/alfred-penny-api-client-documentation.md) · [All operations](https://skmtc.net/alfredpay/apis/alfred-penny-api-client-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alfredpay/alfred-penny-api-client-documentation/revisions/6fdfb13fd2b1/schema)