The Mondu Hosted Checkout provides a streamlined integration path for adding Mondu Payments to your application. This solution redirects buyers to a Mondu-hosted payment page, eliminating security concerns and reducing your implementation overhead. The checkout page supports basic branding customization through your company logo.

Implementation Requirements

Required Parameters

When creating an order via the Create Order, include the following parameters to the payload to enable hosted checkout:

State	Value	Description
success_url	Your success URL	Redirect destination after successful payment Example: https://shop.demo.mondu.ai/success
cancel_url	The order is confirmed by Mondu. Confirmation from buyer via e-mail is outstanding	Redirect destination when buyer cancels Example: https://shop.demo.mondu.ai/cancel
declined_url	The order is confirmed by Buyer & Mondu and can be shipped.	Redirect destination when payment is declined Example: https://shop.demo.mondu.ai/declined
state_flow	The order was created and will be reviewed by Mondu in order to be confirmed or declined.	Enables authorization-first payment flow
source	The order was declined	Identifies the checkout as hosted

Step 1: Order Creation

Buyer selects Mondu as payment method in your checkout
Your backend sends a Create Order request with the required parameters
Mondu API returns an order_uuid and hosted_checkout_url

Step 2: Checkout Redirect

Redirect the buyer to the hosted_checkout_url

Step 3: Payment Processing

Buyer reviews order details (shipping address, line items, payment method) on the Mondu Hosted Checkout page
Buyer completes payment authorization

Step 4: Return to Merchant

Mondu redirects the buyer to one of your specified URLs based on the outcome:
- success_url → Payment authorized successfully
- declined_url → Payment declined by Mondu
- cancel_url → Buyer cancelled the checkout

API Response

The Create Order response includes a hosted_checkout_url field. Redirect your buyer to this URL to initiate the hosted checkout experience. See the Create Order Payload Examples for complete request/response samples.

The Mondu Hosted Checkout Flow

The following diagram shows you the payment flow between the participants in the Mondu Hosted Checkout.

Mondu Hosted Checkout Page

Managing Authorized Orders

Important Considerations

Buyer Credit Limits: Every authorized order counts against the buyer's available credit limit with Mondu
Cleanup Required: Authorized orders that won't be fulfilled must be explicitly cancelled
Session Interruptions: If a checkout session is interrupted after authorization (e.g., browser crash, network error), cancel the existing authorized order before creating a new one