1. Webhook Events
Kutanapay Merchant API
  • Getting Started
  • Authentication
  • Use the API in your application
  • Webhooks
    • Webhooks Events
  • Merchant Checkout
    • Create checkout
      POST
    • List checkouts
      GET
    • Get checkout
      GET
    • Cancel checkout
      POST
    • Create checkout button embed session
      POST
  • Webhook Events
    • Checkout created
    • Checkout paid
    • Customer says they paid
    • Checkout approved
    • Checkout rejected
    • Checkout failed
    • Checkout timed out
    • Checkout expired
    • Checkout refunded
    • A second collection arrived
    • Test event
  • Schemas
    • RequestBodies
      • CheckoutEvent
    • DetailError
    • WebhookEnvelope
    • CheckoutEventData
  1. Webhook Events

Test event

Webhook
POST
test.event
Sent when you press "Send test" in the portal. data is the sample payload you entered. Delivered even if the endpoint is limited to other events.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200
Any 2xx marks the delivery as successful. The response body is stored (first 1000 characters) and otherwise ignored.
This response does not have a body.
⚪default
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://your-api-server.com' \
--header 'X-Webhook-Signature: sha256=5d41402abc4b2a76b9719d911017c5925d41402abc4b2a76b9719d911017c592' \
--header 'X-Webhook-Event: checkout.paid' \
--header 'X-Webhook-Idempotency-Key: 3b1f6c2e-8a4d-4f7b-9c1e-2d5a6b7c8d9e' \
--header 'User-Agent;' \
--header 'Content-Type: application/json' \
--data '{
    "version": "v1",
    "event_type": "test.event",
    "timestamp": "2026-03-26T12:30:00.000000Z",
    "idempotency_key": "3b1f6c2e-8a4d-4f7b-9c1e-2d5a6b7c8d9e",
    "merchant_id": "7a9c2e4b-1d3f-4a6b-8c0e-5f2a1b3c4d5e",
    "data": {
        "source": "portal"
    }
}'
Modified at 2026-10-13 22:36:35
Previous
A second collection arrived
Next
CheckoutEvent
Built with