Documentation

Get all webhook events

This API retrieves a list of all webhook events that have been triggered and sent. The response provides detailed information for each webhook event, including the URL, response, timestamp, and payload details. Pagination options are available to efficiently handle large datasets.


📘

Authentication Route

This route is secured with processor and vendor token authentication.


Endpoint

   /3p/api/v2/webhook-events

 


Query Parameter

FieldsTypeIs RequiredDescription
per_pageintegerNoBy default: 10

Min: 1
Max: 100
start_datestringNoThis parameter will filter the user's records based on the notifying date of the event.

Date format: Y-m-d
end_datestringNoThis parameter will filter the user's records based on the notifying date of the event.

Date format: Y-m-d
sort_orderstringNoBy default: newest

Possible Value:
newest
oldest
event_namestringNoPossible Values:
TransactionStarted
TransactionCaptureStarted
TransactionCompleted
TransactionFailed
TransactionCanceled
PayoutOnHold
PayoutCompleted
ClawbackStarted
ClawbackFailed
ClawbackCompleted
BankLinkedSuccessfully
BankLinkFailed
BusinessCreated
BusinessUpdated
BatchPayout
RefundPending
RefundCaptureStarted
RefundCaptureCompleted
RefundCaptureFailed
RefundPayoutPending
RefundPayoutCompleted
RefundPayoutFailed
BatchRefund
pageintegerNoBy default: 1

Min: 1

Response

{
    "status": true,
    "message": "",
    "data": {
        "webhook_events": [
            {
                "event": "TransactionStarted",
                "webhook_url": "https://...",
                "webhook_payload": {
                    "type": "api",
                    "uuid": "9d1a47df-32b6-43f1-af02-98006171fdfb",
                    "event": "TransactionStarted",
                    "amount": 9900,
                    "status": "CAPTURE_PENDING",
                    "currency": "USD",
                    "created_at": "2024-09-26 14:46:45",
                    "payee_uuid": "9d1a4762-b676-49c4-8ef2-76915537cc49",
                    "payer_uuid": "9d1a3eb3-3bae-45ed-b164-3e60e6030a13",
                    "updated_at": "2024-09-26 14:46:45",
                    "payout_status": null,
                    "capture_status": "CAPTURE_PENDING",
                    "clawback_status": null,
                    "transaction_fee": 0,
                    "payout_delay_days": 2,
                    "client_reference_id": "debit_4578"
                },
                "webhook_response": {
                    "status": true,
                    "status_code": 200
                },
                "date": "2024-09-26 14:48:46"
            },
            {
                "event": "PayoutCompleted",
                "webhook_url": "https://...",
                "webhook_payload": {
                    "type": "api",
                    "uuid": "9d1d8b9b-94fa-48d5-8578-73cbccee77ee",
                    "event": "PayoutCompleted",
                    "amount": 291,
                    "status": "PAYOUT_COMPLETE",
                    "currency": "USD",
                    "created_at": "2024-09-28 05:43:38",
                    "payee_uuid": "9d1d88a1-6158-47ef-bb2d-de194b812602",
                    "payer_uuid": "9d1d8b85-c384-4c8b-b2a8-63770db28a51",
                    "updated_at": "2024-10-01 07:30:25",
                    "payout_status": "PAYOUT_COMPLETE",
                    "capture_status": "CAPTURE_COMPLETE",
                    "clawback_status": null,
                    "transaction_fee": 0,
                    "payout_delay_days": 2,
                    "client_reference_id": "payout_44547"
                },
                "webhook_response": {
                    "status": true,
                    "status_code": 200
                },
                "date": "2024-10-01 08:00:41"
            }
        ],
        "pagination": {
            "total_items": 116,
            "per_page": 10,
            "current_page": 1,
            "total_pages": 12
        }
    },
    "errors": null,
    "error_code": null
}