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.
• 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.
• 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.

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.

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.
• refundable details rabosmartpayconnection v15.0.2 How much of a payment transaction can still be refunded, and until when.
• get refund rabosmartpayconnection v15.0.2 Reads one refund's status. A refund starts PENDING.

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.
• 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.