KashierDevelopersKashier Developers

Test a webhook

curl -X POST "https://test-api.kashier.io/v2/webhooks/string/test" \  -H "Content-Type: application/json" \  -d '{}'
{  "success": true,  "statusCode": 200,  "responseBody": "OK",  "latencyMs": 184}

⚠️ Not yet available on the test environment. This route is not registered on test-api.kashier.io today: calling it there returns a bare 404 rather than sending a test delivery, while the webhook CRUD endpoints on the same router answer normally. It is specified but not shipped, so the "Try it" panel below cannot succeed. Check with your Kashier contact before building against it.

Sends a signed sample payload to a webhook's configured URL so you can confirm the endpoint is reachable and your signature verification works — without waiting for a real event. The test delivery is recorded like any other delivery, but flagged isTest: true so it's distinguishable in your delivery history.

Authorization

secretKey
Authorization<token>

Merchant secret key used to identify the merchant, obtained from Kashier's dashboard. Pass the raw secret key value in the Authorization header (NOT a "Bearer" token).

In: header

Path Parameters

webhookId*string

The webhook's _id.

Request Body

application/json

Optional. Send an empty body (or no body at all) to test the webhook exactly as it is saved. Send any of the fields below to override the saved configuration for this one test delivery only — nothing is written back to the webhook.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

POST
/v2/webhooks/{webhookId}/test