Skip to main content

​
Register Webhook

Register a webhook endpoint to receive notifications for transaction events.

​
API Endpoint

POST https://api.mavapay.co/api/v1/webhook/register

​
Request Parameters

ParameterTypeRequiredDescription
urlstringYesThe URL where webhook events will be sent
secretstringYesA secret key used to sign webhook payloads

​
Example Request

curl -X POST https://api.mavapay.co/api/v1/webhook/register \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key_here" \
  -d '{
    "url": "https://your-domain.com/webhook",
    "secret": "your_webhook_secret"
  }'

​
Example Response

{
  "status": "success",
  "data": {
    "id": "wh_123456789",
    "url": "https://your-domain.com/webhook",
    "isActive": true,
    "createdAt": "2024-03-21T15:30:00Z"
  }
}
For more information about webhooks, see our webhook documentation.