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.iotoday: calling it there returns a bare404rather 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 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
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