Add webhook endpoint (max 5 per environment)

Staging

https://fin-api.digetpay.com

POST

/v1/developer-portal/applications/{appId}/webhooks

Creates a new webhook endpoint that receives signed POST deliveries
for the selected events. Max 5 endpoints per SANDBOX/PRODUCTION environment.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/jsonRequired

Example

{
    "environment": "SANDBOX",
    "url": "https://api.acme.sa/webhooks/digetpay",
    "events": [
        "payment.completed",
        "order.confirmed"
    ],
    "retryLimit": 3
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://fin-api.digetpay.com/v1/developer-portal/applications//webhooks' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "environment": "SANDBOX",
    "url": "https://api.acme.sa/webhooks/digetpay",
    "events": [
        "payment.completed",
        "order.confirmed"
    ],
    "retryLimit": 3
}'

Responses

🟢201Created

This response does not have a body.

Modified at 2026-09-16 09:43:02

List webhook endpoints

Update webhook endpoint

Add webhook endpoint (**max 5 per environment**)

Request

Request Code Samples

Responses

Add webhook endpoint (max 5 per environment)