Skip to main content

Create Order

The first step is to create an order via server-side call to Nemuru's Order API. Make sure to get an access token before calling the POST Create Order, as this request requires authentication.

This step should be done after the customer adds their product(s) to the cart and proceeds to the checkout.

POST Create Order​

Request​

Depending on the sector, there are different article attributes that might be relevant for the lender's credit decisioning. Highlighted lines in the following code blocks point out the main differences between one type of article and another.

POST /order/
Authorization: Bearer access_token
Content-Type: application/json
tip

Check the API Reference for all the details about this request / response.

{
  "product": "instalments",
  "merchant": {
    "order_reference_1": "7QuHQ5WVQQqyWVPW",
    "order_reference_2": "14-922-1039",
    "notification_url": "https://nemuru.free.beeceptor.com/callback",
    "notification_auth": {
      "authorization_header": "Basic bG9sOnNlY3VyZQ==",
      "content_type": "application/json"
    },
    "notification_additional_payload": {
      "cart": "h12837hg="
    }
  },
  "customer": {
    "first_name": "Alba",
    "last_name": "Martinez Laguna",
    "title": "ms",
    "email": "alba.martinez@gmail.com",
    "phone_number": "+34659723349",
    "document_number": "55593310X",
    "document_expiration_date": "2024-02-27T12:00:00+01:00",
    "birth_date": "1982-11-03T12:00:00+01:00",
    "nationality": "ESP",
    "logged_in": false,
    "locale": "es-ES",
    "ip_address": "192.0.2.146",
    "user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36"
  },
  "cart": {
    "reference": "76t7y7sau8y398y",
    "total_price_with_tax": 1500,
    "currency": "EUR",
    "items": [
      {
        "article": {
          "name": "KIVIK 3-seat sofa",
          "type": "product",
          "category": "physical",
          "reference": "4912345678904",
          "unit_price_with_tax": 875,
          "description": "3-seat sofa, with chaise longue/Hillared anthracite",
          "brand": "the-ikea-brand",
          "mpn": "AD6654412-334.22",
          "url": "https://www.ikea.com/ie/en/p/kivik-3-seat-sofa-with-chaise-longue-hillared-anthracite-s89193665/",
          "image_url": "https://www.ikea.com/ie/en/p/kivik-3-seat-sofa-with-chaise-longue-hillared-anthracite-s89193665/"
        },
        "units": 1,
        "total_discount": 0,
        "total_price_with_tax": 875,
        "auto_shipping": true
      },
      {
        "article": {
          "name": "EKEDALEN / EKEDALEN Bar table and 4 bar stools",
          "type": "product",
          "category": "physical",
          "reference": "5930423178914",
          "unit_price_with_tax": 625,
          "description": "Bar table and 4 bar stools, white/Ramna light grey120 cm"
        },
        "units": 1,
        "total_discount": 0,
        "total_price_with_tax": 625
      }
    ]
  },
  "shipping": {
    "name": "SEUR24",
    "method": "home",
    "first_name": "Alba",
    "last_name": "Martinez",
    "company": "EL DON TRESILLO CATALAN SL",
    "email": "alba.martinez@gmail.com",
    "phone_number": "+34659723349",
    "address": {
      "street_address": "Pl. de Pau Vila, 1",
      "street_address_2": "Planta 1A",
      "postal_code": "08003",
      "city": "Barcelona",
      "country": "ESP"
    }
  },
  "billing": {
    "first_name": "Alba",
    "last_name": "Martinez",
    "email": "alba.martinez@gmail.com",
    "phone_number": "+34659723349",
    "company": "EL DON TRESILLO CATALAN SL",
    "corporate_id_number": "A35628221",
    "address": {
      "street_address": "Pl. de Pau Vila, 1",
      "street_address_2": "Planta 1A",
      "postal_code": "08003",
      "city": "Barcelona",
      "country": "ESP"
    }
  }
}

Response​

Response Headers
Date: Thu, 24 Mar 2022 18:20:46 GMT
Content-Type: application/json
...
Id: 41c325c0-161c-43d6-bb4f-65f6b50b9ba0
info

It is important to save the order id returned within the header of a successful response (key Id). This order id should be used in subsequent requests to link them to this particular order; this id will also be included in the notifications that Nemuru sends to your system (notification_url) for order status changes, etc.