Integration

Redirect your customers to the Limonetik payment portal via our Hosted Checkout Page. Find a high level overview in the "Process flows" chapter. 

Add the following properties to a standard CreateHostedCheckout request:

{
  "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
  }
}

Properties	Remarks
customer      merchantCustomerId      contactDetails
references      merchantOrderId      merchantReference
orderLineDetails      productName      discountAmount      lineAmountTotal      productCode      productPrice      productType      quantity      taxAmount	Only send one product item per order in orderLineDetails Always use one productType per order and send fixed value "FoodAndDrink" Only for SodexoBE and Monizze:  productType value can also be : "HomeAndGarden" or "GiftAndFlowers"
redirectPaymentMethodSpecificInput      requiresApproval      paymentProductId	requiresApproval: Set to either "true"/"false" depending on what maintenance operations the individual voucher support. Consult this list to select the correct value If you set requiresApproval to "true", make sure to capture the transaction later via the Merchant Portal or a CapturePayment request. Only then will the transaction have status="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9, for which you receive the actual payment for the transaction paymentProductId: The numeric identifier of the payment method on our platform. Find this id in the "Overview" chapter. It instructs our platform to send your customers directly to the Limonetik portal. This list summarises the available vouchers and the maintenance operations they support.  If left out, our platform sends your customers to the Hosted Checkout Page instead, allowing them to choose this or any other payment method in your account

List of available Mealvouchers

The individual vouchers are available in the Limonetik portal and allow the following maintenance operations:

Brand	Allowed maintenance operations
Monizze	DirectSale Refund (Partial / Multiple / Full)
SodexoBE	DirectSale
PassRestaurant	Authorisation Capture* (Full) Cancellation (Full)
UpChequeDejeuner	Authorisation Capture* (Full) Cancellation (Full)
Swile	DirectSale Authorisation Capture* (Partial/Multiple/Full) Refund (Partial/Multiple/Full) Cancellation (Partial/Multiple/Full)
Apetiz	Authorisation Capture* (Full) Refund (Full) Cancellation (Full)

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