Montonio

To get started, you need to create a Montonio account. The Montonio developer documentation provides all the resources you will need to optimize your payment integration. After getting an account, you will need:

• the Access Key to identify the call
• the Secret Key to sign and verify the signature. This should be kept secret.

Document is clear, it is mentioned and highlighted but if you don’t see it: You can generate the keys under the Stores page of the partner system. Click on your store and navigate to the API Keys tab.

The Remix Run Furniture v2 boilerplate includes a full Montonio integration, including a confirmation webhook.

On the checkout page, we render the Montonio component, which does 3 things:

• makes the cart immutable
• return the link to Montonio with a signed JWT

In this boilerplate, we decided to save the cart in our own service layer, so we push the order to Crystallize only when the payment is successful.

When Montonio redirects the buyer to the shop, it goes to the `/order/cart/${cartId}` page. This page is actually waiting for the Cart to be saved as an order in Crystallize.

Indeed, while everything is happening, Montonio will call the confirm payment endpoint. This works because we provide the notification URL to Montonio during Link creation. (see link above)

The endpoint, when the event concerns a `finalize` payment:

• creates a customer in Crystallize, if one doesn’t exist yet.
• creates the order in Crystallize
• updates the cart from placed to paid, allowing the waiting page to update to the order confirmation

This boilerplate is also using our Node Service API Request Handlers that include 2 handlers to speed up your Montonio integration.