List Webhook Events

curl --request GET \
  --url https://api.fyatu.com/api/v3/webhooks/events \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.fyatu.com/api/v3/webhooks/events"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fyatu.com/api/v3/webhooks/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fyatu.com/api/v3/webhooks/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fyatu.com/api/v3/webhooks/events"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.fyatu.com/api/v3/webhooks/events")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fyatu.com/api/v3/webhooks/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "status": 200,
  "message": "Webhook events retrieved",
  "data": {
    "appType": "ISSUING",
    "events": [
      {
        "event": "card.created",
        "name": "Card Created",
        "category": "card",
        "description": "Triggered when a new card is created for a cardholder"
      },
      {
        "event": "card.funded",
        "name": "Card Funded",
        "category": "card",
        "description": "Triggered when funds are added to a card"
      },
      {
        "event": "card.transaction.approved",
        "name": "Transaction Approved",
        "category": "card",
        "description": "Triggered when a card transaction is approved"
      },
      {
        "event": "cardholder.created",
        "name": "Cardholder Created",
        "category": "cardholder",
        "description": "Triggered when a new cardholder is created"
      },
      {
        "event": "cardholder.kyc_approved",
        "name": "KYC Approved",
        "category": "cardholder",
        "description": "Triggered when KYC verification is approved"
      }
    ],
    "total": 22
  },
  "meta": {
    "requestId": "req_abc123xyz789",
    "timestamp": "2026-01-15T10:30:00+00:00"
  }
}

{
  "success": true,
  "status": 200,
  "message": "Webhook events retrieved",
  "data": {
    "appType": "COLLECTION",
    "events": [
      {
        "event": "collection.initiated",
        "name": "Collection Initiated",
        "category": "collection",
        "description": "Triggered when a payment collection is initiated"
      },
      {
        "event": "collection.received",
        "name": "Collection Received",
        "category": "collection",
        "description": "Triggered when payment is successfully received"
      },
      {
        "event": "payout.completed",
        "name": "Payout Completed",
        "category": "payout",
        "description": "Triggered when a payout is successfully completed"
      },
      {
        "event": "refund.completed",
        "name": "Refund Completed",
        "category": "refund",
        "description": "Triggered when a refund is completed"
      }
    ],
    "total": 10
  },
  "meta": {
    "requestId": "req_def456uvw123",
    "timestamp": "2026-01-15T10:30:00+00:00"
  }
}

GET

webhooks

events

List Webhook Events

curl --request GET \
  --url https://api.fyatu.com/api/v3/webhooks/events \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.fyatu.com/api/v3/webhooks/events"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fyatu.com/api/v3/webhooks/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fyatu.com/api/v3/webhooks/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fyatu.com/api/v3/webhooks/events"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.fyatu.com/api/v3/webhooks/events")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fyatu.com/api/v3/webhooks/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "status": 200,
  "message": "Webhook events retrieved",
  "data": {
    "appType": "ISSUING",
    "events": [
      {
        "event": "card.created",
        "name": "Card Created",
        "category": "card",
        "description": "Triggered when a new card is created for a cardholder"
      },
      {
        "event": "card.funded",
        "name": "Card Funded",
        "category": "card",
        "description": "Triggered when funds are added to a card"
      },
      {
        "event": "card.transaction.approved",
        "name": "Transaction Approved",
        "category": "card",
        "description": "Triggered when a card transaction is approved"
      },
      {
        "event": "cardholder.created",
        "name": "Cardholder Created",
        "category": "cardholder",
        "description": "Triggered when a new cardholder is created"
      },
      {
        "event": "cardholder.kyc_approved",
        "name": "KYC Approved",
        "category": "cardholder",
        "description": "Triggered when KYC verification is approved"
      }
    ],
    "total": 22
  },
  "meta": {
    "requestId": "req_abc123xyz789",
    "timestamp": "2026-01-15T10:30:00+00:00"
  }
}

{
  "success": true,
  "status": 200,
  "message": "Webhook events retrieved",
  "data": {
    "appType": "COLLECTION",
    "events": [
      {
        "event": "collection.initiated",
        "name": "Collection Initiated",
        "category": "collection",
        "description": "Triggered when a payment collection is initiated"
      },
      {
        "event": "collection.received",
        "name": "Collection Received",
        "category": "collection",
        "description": "Triggered when payment is successfully received"
      },
      {
        "event": "payout.completed",
        "name": "Payout Completed",
        "category": "payout",
        "description": "Triggered when a payout is successfully completed"
      },
      {
        "event": "refund.completed",
        "name": "Refund Completed",
        "category": "refund",
        "description": "Triggered when a refund is completed"
      }
    ],
    "total": 10
  },
  "meta": {
    "requestId": "req_def456uvw123",
    "timestamp": "2026-01-15T10:30:00+00:00"
  }
}

List Webhook Events

Returns a list of all webhook event types that can be sent to your app. The events available depend on your app type (Issuing or Collection).

Request

curl -X GET https://api.fyatu.com/api/v3/webhooks/events \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response

success

boolean

Whether the request was successful

data

object

Show properties

appType

string

Your app type: ISSUING or COLLECTION

events

array

List of available webhook events

Show event object

event

string

The event type identifier (e.g., card.created)

name

string

Human-readable event name

Event Categories

Issuing App Events

Category	Events
card	`card.created`, `card.failed`, `card.funded`, `card.funding_failed`, `card.unloaded`, `card.unloading_failed`, `card.frozen`, `card.unfrozen`, `card.terminated`, `card.termination_refund`, `card.termination_refund_post`, `card.replaced`, `card.transaction.approved`, `card.transaction.declined`, `card.transaction.reversed`, `card.transaction.cross_border_fee`, `card.transaction.decline_fee_domestic`, `card.transaction.decline_fee_international`, `card.maintenance_fee_paid`, `card.negative_balance`, `card.delete_warning`, `card.tokenization_otp`, `card.3ds_otp`
cardholder	`cardholder.created`, `cardholder.updated`, `cardholder.kyc_submitted`, `cardholder.kyc_approved`, `cardholder.kyc_rejected`, `cardholder.suspended`, `cardholder.activated`

Collection App Events

Category	Events
collection	`collection.initiated`, `collection.received`, `collection.failed`, `collection.expired`
payout	`payout.initiated`, `payout.completed`, `payout.failed`
refund	`refund.initiated`, `refund.completed`, `refund.failed`

Use Cases

Build a dynamic webhook handler that discovers available events
Display available events in your admin dashboard
Validate event types before testing

Authorizations

Authorization

string

header

required

JWT access token obtained from /auth/token

Response

Webhook events retrieved successfully

success

boolean

Example:

true

status

integer

Example:

200

message

string

data

object

Show child attributes

​List Webhook Events

​Request

​Response

​Event Categories

​Issuing App Events

​Collection App Events

​Use Cases

Authorizations

Response

List Webhook Events

Request

Response

Event Categories

Issuing App Events

Collection App Events

Use Cases