How to resend a webhook from your Fincra Merchant Dashboard

If Fincra sent you a webhook and your system did not receive it, you can send it again yourself. You do this from your Merchant Dashboard. You do not need to contact support.

This guide explains what a webhook is, why one can fail to reach you, and how to resend it. It also explains how to make sure a resent webhook is never processed twice.

What a webhook is

A webhook is an automatic message. Fincra sends it to your system when an event happens on your account. The message tells your system what changed.

For example, Fincra sends a webhook when a pay-in is successful. Your system reads the message and updates the order. You do not have to check for the update yourself. The webhook brings it to you.

Fincra sends each webhook to one address that you set. This address is your webhook URL. You save it in your dashboard settings.

Why a webhook can fail to reach you

A webhook can fail for a few reasons:

• Your server was down for a short time.
• Your endpoint returned an error instead of a success response.
• Your webhook URL was wrong or out of date.
• There was a short network problem between Fincra and your server.

When a webhook does not reach you, Fincra marks it as Failed in your dashboard. A failed webhook is one you can resend.

What resend does

Resend sends the same webhook again to your saved URL. The event data stays the same. Only the delivery is new.

Use resend when your system missed a webhook and you need the data. This is common after a short outage on your side, or after you fix your endpoint.

Resend one webhook

Follow these steps to resend a single webhook:

1. Log in to your Fincra Merchant Dashboard.
2. Click Webhooks in the left menu.
3. Find the webhook you want. Use the filters (status, event type, date) or the search box.
4. Click the row to open Webhook Details.
5. Click Resend webhook at the top right.
6. Click Confirm resend.

A “Webhook resent” message shows. The new attempt appears under Delivery attempts.

Delivery takes a few seconds. Refresh the page to see the updated status.

Resend more than one webhook

You can resend several webhooks at the same time. This is useful after an outage, when many webhooks failed together.

1. Open the Webhooks tab.
2. Set the filter you want. For example, set Status to Failed.
3. Select the webhooks you want. Or click Resend all failed.
4. Click Resend. Then confirm.

What resend covers

You can resend webhooks for these events:

• Pay-ins, including bank transfer and mobile money
• Pay-outs
• Settlements
• Conversions
• Reversals

Things to know before you resend

Keep these points in mind:

• Resend works only for failed webhooks. The dashboard does not send a webhook marked Delivered again. This prevents duplicate delivery of events your system already has.
• Fincra uses your current URL. The resent webhook goes to the URL in your settings now, not the URL from the original attempt. If your URL changed, update it in Settings first. Then resend.
• The Event ID stays the same. A resent webhook keeps the same Event ID as the original. This lets your system recognise it as the same event.

Set up idempotency on your side

Idempotency means that your system gets the same result no matter how many times it processes the same event. It is the safe way to handle a resent webhook.

Here is why it matters. A resent webhook carries the same Event ID as the original. If your system already processed the original, and you resend it, your system could process the same event twice. That can create a duplicate record or a duplicate action.

To prevent this, follow this rule:

1. Save the Event ID of every webhook you process.
2. When a new webhook arrives, check its Event ID against your saved list.
3. If you have already handled that Event ID, ignore the webhook.
4. If the Event ID is new, process the webhook and save the Event ID.

With this rule in place, a resent webhook is never processed twice. You can resend as many times as you need, with no risk of a duplicate.

If the webhook still does not arrive

If you resend a webhook and your system still does not receive it, contact Fincra support. Give these three details from the Webhook Details page:

• The Event ID
• The event type
• The date

These details help the support team find the exact webhook and check what happened.

Summary

You can resend a failed webhook yourself, from your Fincra Merchant Dashboard, in a few clicks. Resend one webhook, or resend many at once. The event data and the Event ID stay the same. Set up idempotency so a resent webhook is never processed twice, and you can retry with confidence.

Go to your dashboard