> For the complete index of the 402pay docs, see [llms.txt](https://developer.402pay.co/llms.txt).

# Send a test event

Deliver a signed sample event to an endpoint to check your handler.

`POST https://dash.402pay.co/api/v1/webhooks/{id}/test`

Sends a signed sample event and returns the delivery. The payload has `test: true` and a made-up subject whose ID contains `_test_`, with only that ID in `data`, so your handler can tell it apart and nothing in your business changes. A test delivery goes out once and isn't retried.

### Path

- `id` (string, required): The webhook endpoint's ID, such as `whk_GFAKLrE8wkBwF4WL`.

### Body

- `event_type` (string): A type the endpoint receives. Defaults to its first one.

### Errors

- 400 `invalid_request` A field is missing, unknown or out of range. `field` names it.
- 404 `not_found` No webhook endpoint with that ID belongs to your business.
- 429 `rate_limited` More than 10 test events and resends in a minute for this business.

Any request can also fail on its key or its body. See [errors](https://developer.402pay.co/api/errors.md).

Request, cURL:

```bash
curl -X POST "https://dash.402pay.co/api/v1/webhooks/whk_GFAKLrE8wkBwF4WL/test" \
  -H "Authorization: Bearer $PAY402_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "event_type": "payment.succeeded"
  }'
```

Request, Node.js:

```js
const response = await fetch("https://dash.402pay.co/api/v1/webhooks/whk_GFAKLrE8wkBwF4WL/test", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.PAY402_SECRET_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    event_type: "payment.succeeded"
  }),
});
const { data } = await response.json();
```

Request, Python:

```python
import os

import requests

response = requests.post(
    "https://dash.402pay.co/api/v1/webhooks/whk_GFAKLrE8wkBwF4WL/test",
    headers={
        "Authorization": f"Bearer {os.environ['PAY402_SECRET_KEY']}",
    },
    json={
        "event_type": "payment.succeeded"
    },
)
data = response.json()["data"]
```

Response, 201 Created:

```json
{
  "data": {
    "id": "dlv_bT1dN9zK1zp9H6Re",
    "kind": "webhook_delivery",
    "webhook_id": "whk_GFAKLrE8wkBwF4WL",
    "event_id": "evt_AncdRQ0YlMsNNIQD",
    "event_type": "payment.succeeded",
    "subject": {
      "kind": "payment",
      "id": "pmt_test_wcKbRA2NP8gXhlmr"
    },
    "status": "succeeded",
    "response_status": 200,
    "duration_ms": 269,
    "attempt": 1,
    "attempts": [
      {
        "at": "2026-09-26T21:23:17.117Z",
        "response_status": 200,
        "duration_ms": 269,
        "trigger": "manual"
      }
    ],
    "next_retry_at": null,
    "request_headers": {
      "content-type": "application/json",
      "webhook-id": "evt_AncdRQ0YlMsNNIQD",
      "webhook-timestamp": "1790457797",
      "webhook-signature": "v1,erz2/ak2MUN/eIaREBRHTG9nfipCw9fZ2VcWbYByqw4="
    },
    "payload": {
      "id": "evt_AncdRQ0YlMsNNIQD",
      "kind": "event",
      "type": "payment.succeeded",
      "subject": {
        "kind": "payment",
        "id": "pmt_test_wcKbRA2NP8gXhlmr"
      },
      "data": {
        "id": "pmt_test_wcKbRA2NP8gXhlmr"
      },
      "actor": {
        "kind": "system",
        "id": null,
        "name": null
      },
      "mode": "live",
      "test": true,
      "api_version": "v1",
      "created_at": "2026-09-26T21:23:17.117Z"
    },
    "created_at": "2026-09-26T21:23:17.117Z"
  }
}
```