Register a webhook URL for payment notifications. Requires Merchant Portal Bearer token.

Flow

sequenceDiagram
    autonumber
    participant A as Portal Admin
    participant D as DigetPay Portal API
    participant M as Your Server

    A->>D: POST /merchant/account/webhooks
    D-->>A: 201 { id, url, secret }
    Note over A: Store signing secret securely
    Note over D,M: On payment events, DigetPay POSTs signed payload to your url
    D->>M: POST webhook (payment.success / payment.failed)
    M-->>D: 200 OK

Responses

{
  "success": {
    "status": 201,
    "body": {
      "id": "wh_abc123",
      "url": "https://yourstore.com/webhooks/digetpay",
      "secret": "whsec_shown_once",
      "active": true
    }
  }
}

{
  "failed": {
    "status": 400,
    "body": {
      "statusCode": 400,
      "message": "Invalid webhook URL",
      "error": "Bad Request"
    }
  }
}

{
  "failed_unauthorized": {
    "status": 401,
    "body": {
      "statusCode": 401,
      "message": "Unauthorized",
      "error": "Unauthorized"
    }
  }
}

Guide →