---
title: "process webhook · RUAL Documentation"
description: "Handles a Smart Pay webhook end to end. The notification carries no order, only a token, so this block verifies the notification's signature, pulls the…"
canonical: https://docs.rual.nl/block-types/rabosmartpay/rabosmartpayconnection_webhook_process
language: en
---

# process webhook

This block is part of the [`rabosmartpay`](https://docs.rual.nl/block-types/rabosmartpay) group and was last modified in core [`v15.0.2`](https://docs.rual.nl/core-versions/150002).

Handles a Smart Pay webhook end to end. The notification carries no order, only a token, so this block **verifies the notification's signature**, pulls the changed orders with its token, and **verifies every page of results** before any of them reaches `order results`. Wire the request body into `payload`. Smart Pay hands each result out once: store what you act on before the endpoint answers.

- flow

- connection `rabosmartpayconnection` required

- request body `value` required The body Smart Pay posted, as the raw string or the parsed object : the signature covers the values, so both verify.

- flow

- connection `rabosmartpayconnection`

- verified `condition` **Gate everything on this.** False means the notification was not signed with the provider's signing key.

- order results `array ` One entry per changed order, each signature-checked: `merchant_order_id`, `order_id`, `status`, `paid`, `paid_amount`, `total_amount`, `currency`, `transaction_id`, `payment_brand`, `status_at`, `transactions`.

- count `number`

- event name `value` `merchant.order.status.changed`.

- webshop id `value` The point of interaction (webshop) the notification is for.

- success `condition`

- error `value` Smart Pay's own message, e.g. *merchantOrderId should only contain alphanumeric characters*, or a sentinel for a problem in the wiring.

- error code `value` Smart Pay's code (`5017` validation, `5001` authorization) or a sentinel like `SIGNATURE_MISMATCH`.

| `rabo webhook` |
| --- |
| `smart pay notification` |
| `order status changed` |
| `payment hook` |
| `verify signature` |

## Version history

Introduced in [`v15.0.2`](https://docs.rual.nl/core-versions/150002).

## Service documentation

- [External API reference](https://docs.developer.rabobank.com/smartpay/reference/integration-guide): This block wraps a third-party service. Click here for the service's own documentation of the underlying endpoint.

- [Back to `rabosmartpay`](https://docs.rual.nl/block-types/rabosmartpay): Return to the main group to view all sub-groups

- [Back to `webhooks`](https://docs.rual.nl/block-types/rabosmartpay?group=webhooks): Return to the group to view all blocks within this group