Create Order

post

https://api.demo.mondu.ai/api/v1/orders

Creates new Order

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Use Case:

Send create order request when the buyer clicks pay with Mondu in the checkout.
Send buyer data, the cart content and the redirect URLs.
The API would return a hosted page URL.
Redirect buyer to Mondu Hosted Checkout Page.
Mondu will communicate the result of the risk check through the Mondu Hosted Checkout Page.
Buyer will be redirected to the shop by Mondu Hosted Checkout Page.
Send Confirm Order request to confirm that the order was successfully created in your system.

Important:

The order will get status Authorized when buyers approve the order in Mondu Hosted Checkout Page.
The order will get status Confirmed when Mondu receives Confirm Order request from your system.
Ship products only when the order status is set to Confirmed.
The order status change is communicated through the webhooks.
The confirmed order is valid for 90 days and will be automatically cancelled by the Mondu system after 90 days.

Get Payload Examples:

Check Mondu Guides:

Body Params

currency

string

enum

required

Defaults to EUR

Currency code according ISO_4217 i.e EUR

Allowed:

external_reference_id

string

required

length between 1 and 1024

Reference ID of resource in external service

vendor_external_reference_id

string

length between 1 and 1024

Reference ID of resource in external service

notes

string

length between 1 and 1024

billing_address

object

required

Billing address details.

shipping_address

object

required

Shipping address details.

gross_amount_cents

integer

≥ 1

The gross amount of the order.

total_discount_cents

integer

≥ 0

Discount to be applied on all order lines.

language

string

enum

Defaults to en

Two-letter language code according to ISO_639-1 i.e. en

Allowed:

net_term

integer

≥ 1

Custom net term for merchant.Income value must be one of the predefined values in the account

merchant_informed_buyer

boolean

success_url

string

A URL to redirect buyers after a successful order from hosted checkout.

cancel_url

string

A URL to redirect buyers after a canceled order from hosted checkout.

declined_url

string

A URL to redirect buyers after a declined order from hosted checkout.

billing_configuration_uuid

uuid

length between 36 and 36

UUID of an existing billing configuration

additional_discount

object

Additional Discount.

buyer

object

required

Buyer details.

lines

array of objects

required

≥ 1

Order details.

lines*

payment_method

string

enum

Defaults to invoice

Allowed:

Responses

403

Forbidden

422

Unprocessable Entity

Use Case:

Important:

Get Payload Examples:

Check Mondu Guides:

201successful