---
title: "Handle TransferMate webhook events"
method: POST
path: "/api/v1/webhooks/transfermate"
tags: ["Webhooks"]
---

# Handle TransferMate webhook events

`POST /api/v1/webhooks/transfermate`

Handle TransferMate webhook events

## Request body

- TransfermateWebhookInput — TransferMate webhook payload
  - `event_id` string, required — Unique identifier for this specific webhook call
  - `customer_id` string, required — ID of customer requesting the webhook
  - `event_code` string, required — Numeric code identifying the webhook type
  - `event_details` object — Event-specific details that vary by event type
    - `Unique_Record_id` string
    - `description` string
    - `status` string
    - `updated_at` string
    - `value_date` string
    - `Global_Account` string
    - `currency` string
    - `amount` string
    - `payer` string
    - `ga_account_id` number
    - `reference` string
    - `rail_type` string

## Response `200`

Success

- TransfermateWebhookSuccessResponse — TransferMate webhook acknowledgment response (echoes payload)
  - `event_id` string, required — Unique identifier for this specific webhook call
  - `customer_id` string, required — ID of customer requesting the webhook
  - `event_code` string, required — Numeric code identifying the webhook type
  - `event_details` object — Event-specific details that vary by event type
    - `Unique_Record_id` string
    - `description` string
    - `status` string
    - `updated_at` string
    - `value_date` string
    - `Global_Account` string
    - `currency` string
    - `amount` string
    - `payer` string
    - `ga_account_id` number
    - `reference` string
    - `rail_type` string

## Other responses

- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/banqzinc/apis/quidkey-api.md) · [All operations](https://skmtc.net/banqzinc/apis/quidkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banqzinc/quidkey-api/revisions/f86d2bdbcb08/schema)