---
title: "Transfer Request Webhook"
source_url: https://docs.rapyd.net/en/transfer-request-webhook.html
lang: en
---

# Transfer Request Webhook

The **TransferRequest** webhook notifies a Rapyd partner that a transfer request was created.

> **Note:**
>
> The endpoint for webhooks is unique for each client. To set up a webhook endpoint, see [Defining a Webhook Endpoint](https://docs.rapyd.net/en/defining-a-webhook-endpoint.md "Defining a Webhook Endpoint").

### Parameters

### Webhook Header Parameters

- - Content-Type
  - Indicates that the data appears in JSON format. Set to **application/json**.
- - salt
  - Random string.
- - signature
  - Signature calculated for each webhook individually.

    See [Webhook Authentication](https://docs.rapyd.net/en/webhook-authentication.md "Webhook Authentication").
- - timestamp
  - Timestamp for the webhook, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time") (seconds).

### Webhook Root Parameters

- - created_at
  - Time that the webhook was created, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time").

    > **Note:**
    >
    > Inside the `data` object, some webhooks have another `created_at` field that refers to a different event.
- - data
  - Contains the actual data of the webhook.

    For details, see below.
- - extended_timestamp
  - Time in milliseconds that the webhook was created, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time").
- - id
  - ID of the webhook. String starting with **wh_**.
- - status
  - Status of the webhook. One of the following:

    - **NEW**
    - **CLO** - Closed.
    - **ERR** - Error.
    - **RET** - Re-sent.

    > **Note:**
    >
    > Inside the `data` object, some webhooks have another `status` field that refers to a different event.
- - trigger_operation_id
  - ID of the operation that triggered the webhook. UUID.
- - type
  - Name of the webhook type.

    > **Note:**
    >
    > The name in the Client Portal is different.

### Webhook Data Parameters

- - amount
  - Amount of the transaction, in units of the currency defined in currency.
- - currency
  - Three-letter ISO 4217 code for the currency used in the 'amount' field.
- - destination_phone_number
  - Phone number of the owner of the wallet receiving the money, in E.164 format.
- - id
  - ID of the transaction. UUID.
- - source_phone_number
  - Phone number of the owner of the wallet sending the money, in E.164 format.
- - timestamp
  - Time of the operation, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time").
- - type
  - Webhook type - **TransferRequest**

- TransferRequest Webhook
- ```json
  {
      "type": "TransferRequest",
      "id": "bacb2e2e-42ce-11ea-8193-0e0450a4edb1",
      "source_phone_number": "+11580326555",
      "destination_phone_number": "+11580326562",
      "amount": 14.15,
      "currency": "USD",
      "timestamp": "1580326625"
  }
  ```