Integration

Redirect your customers to the Limonetik payment portal via our Hosted Checkout Page.

Add the following properties to a standard request CreateHostedCheckout request:

Properties	Remarks
customer merchantCustomerId contactDetails
references merchantOrderId merchantReference
orderLineDetails productName discountAmount lineAmountTotal productCode productPrice productType quantity taxAmount	Use orderLineDetails for only one item per order Always send fixed value “FoodAndDrink” for productType
redirectPaymentMethodSpecificInput.paymentProductId	Instructions to our platform for the redirection to the Limonetik payment portal

Find detailed information about this object and its properties in our Hosted Checkout API.

A typical request looks like this:

{
  "order": {
    "amountOfMoney": {
      "currencyCode": "EUR",
      "amount": 1000
    },
    "customer": {
      "merchantCustomerId": "mc_{{TIMESTAMP}}",
      "contactDetails": {
        "emailAddress": "wile.e.coyote@acmelabs.com"
      }
    },
    "references": {
      "merchantOrderId": "{{TIMESTAMP}}",
      "merchantReference": "mr_{{TIMESTAMP}}"
    },
    "shoppingCart": {
      "items": [
        {
          "amountOfMoney": {
            "currencyCode": "EUR",
            "amount": 1000
          },
          "invoiceData": {
            "description": "Food"
          },
          "orderLineDetails": {
            "productName": "ACME12",
            "discountAmount": 0,
            "lineAmountTotal": 100,
            "productCode": "ASO45",
            "productPrice": 1000,
            "productType": "FoodAndDrink",
            "quantity": 1,
            "taxAmount": 0,
            "unit": "piece"
          }
        }
      ]
    }
  },
  "redirectPaymentMethodSpecificInput": {
    "requiresApproval": true,
    "paymentProductId": 5402
  }
}

The individual payment methods allow the following operations for transaction processing:

	DirectSale	Authorisation	Capture*	Refund	Cancellation
Monizze	Yes	No	No	Yes Partial Multiple Full	No
SodexoBE	Yes	No	No	No
PassRestaurant	No	Yes	Yes Full	No	Yes Full
UpChequeDejeuner	No	Yes	Yes Full	No	Yes Full
Swile	Yes	Yes	Yes Partial Multiple Full	Yes Partial Multiple Full	Yes Partial Multiple Full
Apetiz	No	Yes	Yes Full	Yes	Yes Full

*Limonetk automatically captures all authorisations from the same day at midnight