---
title: "Block - Main Group - rabosmartpay · RUAL Documentation"
description: "9 RUAL blueprint blocks in the rabosmartpay main group, sorted into 4 groups. Open a group to find a block, its pins and version history."
canonical: https://docs.rual.nl/block-types/rabosmartpay
language: en
---

# rabosmartpay

9 blocks in 4 groups. Open a block for its pins, an example and how it behaves.

## payments

- [get payment `rabosmartpayconnection` `v15.0.2` Reads an order as Smart Pay holds it now: was it paid, with what, and which transaction to refund. The answer that does not depend on the customer coming back or on a webhook arriving — Smart Pay asks for it as the fallback to the webhook, not as a polling loop.](https://docs.rual.nl/block-types/rabosmartpay/rabosmartpayconnection_order_get)

- [list payment brands `rabosmartpayconnection` `v15.0.2` The payment brands configured on the webshop and whether each is active, for a checkout that offers only what will work.](https://docs.rual.nl/block-types/rabosmartpay/rabosmartpayconnection_paymentbrands_list)

- [create payment `rabosmartpayconnection` `v15.0.2` Announces an order to Rabo Smart Pay and returns the redirect url of the hosted payment page — redirect the customer there. Nothing is paid yet: the outcome comes back on the return URL, through the webhook (process webhook) and from get payment. Fulfil on the webhook or get payment, never on the return URL alone.](https://docs.rual.nl/block-types/rabosmartpay/rabosmartpayconnection_order_create)

## rabosmartpay

- [connect `rabosmartpayconnection` `v15.0.2` Opens a Rabo Smart Pay connection from a service provider holding the webshop's refresh token and signing key. The credentials stay in the provider store; the connection carries only the provider's name. Leave the provider empty to use the entity's payments binding.](https://docs.rual.nl/block-types/rabosmartpay/function_create_rabosmartpay)

## refunds

- [create refund `rabosmartpayconnection` `v15.0.2` Refunds all or part of a payment transaction. Wire an `idempotency key` that is stable per refund: Smart Pay answers a repeated key with the first refund instead of making a second one.](https://docs.rual.nl/block-types/rabosmartpay/rabosmartpayconnection_refunds_create)

- [refundable details `rabosmartpayconnection` `v15.0.2` How much of a payment transaction can still be refunded, and until when.](https://docs.rual.nl/block-types/rabosmartpay/rabosmartpayconnection_refunds_refundable)

- [get refund `rabosmartpayconnection` `v15.0.2` Reads one refund's status. A refund starts `PENDING`.](https://docs.rual.nl/block-types/rabosmartpay/rabosmartpayconnection_refunds_get)

## webhooks

- [verify return `rabosmartpayconnection` `v15.0.2` Checks the `order_id`, `status` and `signature` Smart Pay appends to the return URL, so a customer cannot type `status=COMPLETED`. Good for choosing the page to show; fulfil on the webhook, because a customer who closes the tab never comes back.](https://docs.rual.nl/block-types/rabosmartpay/rabosmartpayconnection_return_verify)

- [process webhook `rabosmartpayconnection` `v15.0.2` 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.](https://docs.rual.nl/block-types/rabosmartpay/rabosmartpayconnection_webhook_process)

- [All block groups](https://docs.rual.nl/block-types): Back to the overview of every group.