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

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	requiresApproval Set to "false" as this payment method allows only direct sale operations  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. 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 paymentOption contains a value to indicate the transaction is split into 3 or 4 instalments. The values for are defined by you and Limonetik