Direct Support Site

Results for

icon-search-large No search results yet
Enter your search query above
Page topics

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