Integration

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

Add the following properties to a standard CreateHostedCheckout request:

Properties	Remarks
order.customer merchantCustomerId personalInformation companyInformation languageCode billingAddress shippingAddress contactDetails vatNumber	If you do not send shippingAddress, your customers will have to provide this data on the Limonetik portal
references merchantOrderId merchantReference invoiceData descriptor	-
typeInformation.purchaseType	-
hostedCheckoutSpecificInput.locale	-
redirectPaymentMethodSpecificInput requiresApproval paymentProductId paymentOption	paymentProductId instructs our platform to send your customers directly to the Limonetik portal paymentOption contains a value to indicate the transaction is split into 3 or 4 instalments. The values for are defined by you and Limonetik

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": 170000
    },
    "customer": {
      "personalInformation": {
        "name": {
          "title": "Mr.",
          "firstName": "Dupont",
          "surname": "Jean"
        },
        "gender": "male",
        "dateOfBirth": "19490917"
      },
      "billingAddress": {
        "street": "bd de Rochechouart",
        "houseNumber": "13",
        "zip": "75009",
        "city": "Paris",
        "state": "Paris",
        "countryCode": "FR"
      },
      "shippingAddress": {
        "street": "bd de Rochechouart",
        "houseNumber": "13",
        "zip": "75009",
        "city": "Paris",
        "state": "Paris",
        "countryCode": "FR"
      },
      "contactDetails": {
        "emailAddress": "jean.dupont@test.com",
        "phoneNumber": "+330175757575"
      }
    },
    "references": {
      "merchantOrderId": "{{TIMESTAMP}}"
    },
    "shoppingCart": {
      "items": [
        {
          "amountOfMoney": {
            "currencyCode": "EUR",
            "amount": 170000
          },
          "orderLineDetails": {
            "productName": "ACME12",
            "discountAmount": 0,
            "lineAmountTotal": 170000,
            "productCode": "ASO45",
            "productPrice": 170000,
            "productType": "Fashion",
            "quantity": 1,
            "taxAmount": 0,
            "unit": "piece"
          }
        }
      ]
    }
  },
  "hostedCheckoutSpecificInput": {
    "locale": "fr_FR"
  },
  "redirectPaymentMethodSpecificInput": {
    "requiresApproval": true,
    "paymentProductId": 5110,
    "paymentOption": "W3122"
  }
}