Overview

This node acts as a webhook trigger for BVNK payment status changes. It listens for incoming HTTP POST requests from BVNK webhooks, verifies the request signature for security, and triggers a workflow when a payment status change event is received. This is useful for automating processes based on payment status updates, such as updating order statuses, notifying users, or logging payment events.

Use Case Examples

1. Trigger a workflow to update a database record when a payment status changes in BVNK.
2. Send a notification email when a payment status changes to 'completed'.
3. Log payment status changes for auditing purposes.

Output

JSON

• source - The source of the event, expected to be 'payment'.
• event - The event type, expected to be 'statusChanged'.
• body - The full webhook payload received from BVNK containing payment status details.

Dependencies

• Requires BVNK API credentials including a webhook secret for signature verification.

Troubleshooting

• Missing 'x-signature' header in the webhook request will cause the node to ignore the event.
• If the signature verification fails, the node will log a warning and ignore the event to prevent unauthorized triggers.
• If the event source or type does not match 'payment' and 'statusChanged', the node will ignore the event.
• Ensure the webhook URL configured in BVNK matches the node's webhook URL to avoid signature mismatches.

Links

• BVNK Webhook Documentation - Official documentation for BVNK webhooks and event types.