Register Webhook Endpoint

https://auth.zamupay.com

POST

/apps/graph/api/v1/cybersource/webhooks

Registers a partner HTTPS URL to receive real-time event notifications.

Supported event types:

payment.authorised

payment.authorisation_failed

payment.captured

payment.voided

payment.refund_initiated

payment.refund_failed

fraud.rejected

authentication.completed

Retry Policy: Up to 5 retries with exponential backoff (30s → 2min → 10min → 30min → 2hr). After 5 failures the webhook is marked INACTIVE.

Your endpoint must respond within 5 seconds — offload all processing to a background queue.

Request

Authorization

Header Params

Body Params application/json

Examples

Responses

🟢201

text/plain

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://auth.zamupay.com/apps/graph/api/v1/cybersource/webhooks' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data '{
  "Url": "https://checkout.partner.com/webhooks/zamupay",
  "Events": [
    "payment.captured",
    "payment.refund_initiated",
    "payment.voided",
    "fraud.rejected"
  ],
  "Description": "ZamuPay sandbox event listener",
  "SigningSecret": "wh_sec_aB3cD4eF5gH6iJ7k"
}'

Response Example

{
  "WebhookId": "WH-00112",
  "Url": "https://checkout.partner.com/webhooks/zamupay",
  "Events": ["payment.captured", "payment.refund_initiated", "payment.voided", "fraud.rejected"],
  "Description": "ZamuPay sandbox event listener",
  "Status": "ACTIVE",
  "CreatedAt": "2025-04-24T11:30:00Z"
}

Modified at 2026-05-07 13:08:30

Get Transaction by ID

List Registered Webhooks