Resend Webhook Notification

Manually trigger a webhook notification for a specific transaction

Post https://dashboard.mbiyo.africa/api/v1/merchant/transactions/{transaction_id}/resend-webhook

Note: Use this endpoint to manually resend webhook notifications for a transaction. This is useful when your webhook endpoint was temporarily unavailable or you need to reprocess a notification.

Headers

Authorization* string

Pass your merchant API key as a bearer token in the request header to authorize this call

Content-Type* string

application/json

Path Parameters

transaction_id* string

The unique transaction reference ID (e.g., TXN-1234567890ABCDEF)

Example Request


curl -X POST "https://dashboard.mbiyo.africa/api/v1/merchant/transactions/TXN-1234567890ABCDEF/resend-webhook" \
  -H "Authorization: Bearer YOUR_MERCHANT_API_KEY" \
  -H "Content-Type: application/json"

Success Response (200 OK)


{
  "status": "success",
  "message": "Webhook sent successfully",
  "data": {
    "transaction_id": "CO-695E8FF9383839393",
    "webhook_url": "https://webhook.site/a232416f"
  }
}

Error Response (404 Not Found)


{
  "status": "error",
  "message": "Transaction not found",
  "data": null
}

Webhook Payload Sent

The webhook notification will be sent to your configured callback URL (or the default webhook URL) with the following payload:


{
  "event": "payment.status.updated",
  "transaction_id": "TXN-1234567890ABCDEF",
  "order_id": "ORDER-12345",
  "status": "successful",
  "amount": 1000,
  "fee": 15,
  "currency": "XOF",
  "payment_method": "mobile_money",
  "updated_at": "2025-12-16T10:35:00Z"
}

Use Cases

Your webhook endpoint was temporarily down when the original notification was sent
You need to reprocess a transaction notification in your system
Testing your webhook integration with real transaction data
Debugging webhook processing issues

Important Notes

Idempotency: Resending a webhook does not change the transaction status or create a duplicate transaction
Rate Limiting: Avoid excessive webhook resends. Implement proper error handling in your webhook endpoint instead
Webhook URL: The notification will be sent to the callback_url specified in the original transaction request, or your default webhook URL if none was specified