Skip to main content
POST
/
webhooks
/
test
Test Webhook
curl --request POST \
  --url https://api.fyatu.com/api/v3.20/webhooks/test \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "eventType": "card.transaction.approved"
}
'
{
  "success": true,
  "status": 123,
  "message": "<string>",
  "meta": {
    "requestId": "req_9f3e2a1b4c5d67e8",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Send a test webhook to your configured webhook URL. Use this to verify your endpoint is reachable, returns 2xx, and correctly validates the signature.

​
Request Body

FieldTypeRequiredDescription
eventstringNoEvent type to simulate (default: card.transaction.approved)

​
Test Payload

The test request sends a realistic-looking payload signed with your current webhookSecret: 
{
  "event": "card.transaction.approved",
  "version": "3.20",
  "sign": "hmac_sha256_signature_using_your_secret",
  "data": {
    "transactionId": "txn_test_abc123",
    "cardId": "crd_test_9x8y7z6w",
    "cardholderId": "CH-TEST-ABC123",
    "merchantName": "Test Merchant",
    "merchantCategory": "0000",
    "amount": 1.00,
    "currency": "USD",
    "balance": 99.00,
    "status": "APPROVED",
    "timestamp": "2026-04-30T10:35:00+00:00"
  },
  "timestamp": "2026-04-30T10:35:00+00:00"
}

​
Response

{
  "success": true,
  "data": {
    "delivered": true,
    "httpStatus": 200,
    "responseTime": 142
  }
}
FieldDescription
deliveredtrue if your endpoint returned 2xx
httpStatusHTTP status code your endpoint returned
responseTimeRound-trip time in milliseconds

​
Error Codes

CodeDescription
WEBHOOK_NOT_CONFIGUREDNo webhook URL has been set
WEBHOOK_DELIVERY_FAILEDYour endpoint did not return 2xx
Run a test webhook after any deployment or secret rotation to confirm everything is working before live traffic arrives.

Authorizations

​
Authorization
string
header
required

JWT access token obtained from POST /auth/token

Body

application/json
​
eventType
string
Example:

"card.transaction.approved"

Response

200 - application/json

Test event sent

​
success
boolean
Example:

true

​
status
integer
​
message
string
​
meta
object