Webhook notifications in Donor Fuse allow you to receive real-time updates about key events in your account—such as new payments or payment updates—directly to your software system.

Setting Up a Webhook

1. Login to the Donor Fuse Portal
   • Access your account using your usual credentials.
2. Navigate to Account Settings
   • Go to Settings → Account Settings.
3. Expand the Integrations Section
   • Find the Integrations area, where you'll see your API keys and a list of existing webhooks.
4. Add a New Webhook
   • Click the Add New Webhook button on the right.
5. Configure the Webhook
   • In the popup window, fill out the following fields:
     • Software Name (required): Enter the name of the software or integration.
     • URL (required): Enter the endpoint URL where notifications should be sent.
     • Header Key and Header Value (optional): If your endpoint requires custom headers (e.g., for authentication), enter them here.
   • Select one or more event types you wish to subscribe to:
     • New Donor (coming soon)
     • Donor Updated (coming soon)
     • New Donation (coming soon)
     • Donation Updated (coming soon)
     • New Payment
     • Payment Updated (includes payment voided)
     • New Schedule (coming soon)
   • Click Save New Webhook.
6. Webhook List Management
   • The new webhook will appear in your list of webhooks.
   • You can edit a webhook by clicking it—this opens the same popup, allowing you to change any setting.
   • You can delete a webhook by clicking the delete icon and confirming your choice.

How Webhook Notifications Work

Whenever a relevant event occurs (e.g., a new payment is added or a payment is updated/voided), Donor Fuse will send a POST request to your specified endpoint.

• If you configured a header key/value, it will be included in every request.
• The request body will be in JSON format and will include detailed information about the event.

Example Payloads

New Payment

{
  "WebhookType": "PaymentNew",
  "Object": {
    "PaymentId": 12345,
    "Date": "2025-07-27",
    "Type": "Payment",
    "PaymentType": "Cash",
    "Amount": 10,
    "CurrencyAmount": 10,
    "CurrencyCode": "USD",
    "SourceType": "Org Portal",
    "SourceId": null,
    "PaymentStatus": "Success",
    "ReferenceNumber": "",
    "PaymentMethodInfo": "",
    "GatewayAccountId": null,
    "GatewayAccount": null,
    "Donor": {
      "DonorId": 11111,
      "FullName": "Donor Name",
      "HebrewFullName": "",
      "SourceId": "SRC7455",
      "SourceIds": [
        {
          "SourceName": "Source System",
          "Value": "SRC_11112"
        }
      ]
    },
    "Account": {
      "AccountId": 22222,
      "AccountName": "Account Name"
    },
    "AppliedTo": [
      {
        "DonationId": 33333,
        "Amount": 10,
        "DonorId": 11111
      }
    ]
  }
}

Payment Updated

{
  "WebhookType": "PaymentUpdate",
  "Object": {
    "PaymentId": 12346,
    "Date": "2025-05-08",
    "Type": "Payment",
    "PaymentType": "Credit Card",
    "Amount": 1,
    "CurrencyAmount": 1,
    "CurrencyCode": "USD",
    "SourceType": "Org Portal",
    "SourceId": null,
    "PaymentStatus": "Success",
    "ReferenceNumber": "txn_ABC123XYZ",
    "PaymentMethodInfo": "Visa-1234",
    "GatewayAccountId": 44444,
    "GatewayAccount": "Payment Gateway",
    "Donor": {
      "DonorId": 11111,
      "FullName": "Donor Name",
      "HebrewFullName": "",
      "SourceId": null,
      "SourceIds": []
    },
    "Account": {
      "AccountId": 22222,
      "AccountName": "Account Name"
    },
    "AppliedTo": [
      {
        "DonationId": 33334,
        "Amount": 1,
        "DonorId": 11111
      }
    ]
  }
}

Payment Voided (Deleted)

{
  "WebhookType": "PaymentUpdate",
  "Object": {
    "PaymentId": 12347,
    "Date": "2025-07-27",
    "Type": "Payment",
    "PaymentType": "Check",
    "Amount": 7,
    "CurrencyAmount": 7,
    "CurrencyCode": "USD",
    "SourceType": "Org Portal",
    "SourceId": null,
    "PaymentStatus": "Voided",
    "ReferenceNumber": "CHK12345",
    "PaymentMethodInfo": "",
    "GatewayAccountId": null,
    "GatewayAccount": null,
    "Donor": {
      "DonorId": 11112,
      "FullName": "Donor Name",
      "HebrewFullName": "",
      "SourceId": null,
      "SourceIds": []
    },
    "Account": null,
    "AppliedTo": []
  }
}

What’s Included in the Payload

• Basic payment information (amount, type, status, etc.)
• Donor details (name, IDs, etc.)
• Account information
• Associated donation records

Frequently Asked Questions

Q: Can I edit or delete my webhooks after creating them?
A: Yes, you can edit any webhook or delete it at any time.

Q: What if I need to add authentication to my webhook endpoint?
A: Use the Header Key/Value fields to include custom headers, such as API keys or authorization tokens.

Q: What event types are currently supported?
A: As of now, “New Payment” and “Payment Updated” (including voided payments) are supported. Other event types will be available soon.

If you need further assistance or have questions about specific webhook payloads, please contact Donor Fuse support.