Skip to main content

Ingrid Adapter

Ingrid Delivery Platform, which can be used to power Walley Checkout, connects retailers, carriers and consumers to create a better shopping experience for everyone.

How to get started 🚀​

  1. Contact Walley Merchant Services for help with setup in our test environment and for questions regarding integration Ingrid.
  2. If you dont have one already, then create an account with Ingrid
  3. Provide Walley Merchant Services with Ingrid API key as well as what fallback strategy to use.
Ingrid
Ingrid developer documentation
Ingrid support documentation for Walley Integration

Loyalty booster synergies​

If you are using any of our loyalty boosters then we will forward some loyalty information to Ingrid. For example if a customer is a member then we will send to ingrid: loyalty-isMember:Yes/No/New where

  • Yes: The customer is an existing member.
  • No: The customer is not a member and has opted out of becoming one.
  • New: The customer is not a member but has opted in to become one.

Extending regular Walley API requests​

Walley checkout with Ingrid might require more information than a regular walley checkout. Below are examples of how to extend the regular Walley API requests to include the necessary information for Ingrid.

/*
POST /checkouts HTTP/1.1
Host: api.uat.walleydev.com // (Please note! Different hostname in production)
Authorization: Bearer bXlVc2VybmFtZTpmN2E1ODA4MGQzZTk0M2VmNWYyMTZlMDE...
Content-Type: application/json
*/

{
  ...,
  "cart": {
    "items": [
      {
        "id": "10001",
        "description": "A product description",
        "unitPrice": 5.0,
        "quantity": 1,
        "vat": 25.0,
        "requiresElectronicId": true,
        "sku": "1111-111-1111",
        "shipping": {
          "tags": ["session-cart-item-tag"],
          "unitWeight": 10.0,
          "dimensions": {
            "height": 10,
            "length": 10,
            "width": 10
          },
          "shippingInterval": {
            "startDate": "2024-01-01T00:00:00",
            "endDate": "2024-01-07T00:00:00",
            "alternatives": [
              {
                "name": "alternative-name",
                "shippingInterval": {
                  "startDate": "2024-01-01T00:00:00",
                  "endDate": "2024-01-07T00:00:00"
                }
              }
            ]
          }
        }
      }
    ],
  },
  ...,
  "shipping": {
    "tags": ["session-cart-tag"],
    "shipments": [
      {
        "tags": ["session-shipment-tag"],
        "id": "shipment-1",
        "contents": [
          {
            "quantity": 1,
            "sku": "1111-111-1111"
          }
        ]
      }
    ],
    "shippingInterval": {
      "startDate": "2024-01-01T00:00:00",
      "endDate": "2024-01-07T00:00:00",
      "alternatives": [
        {
          "name": "alternative-name",
          "shippingInterval": {
            "startDate": "2024-01-01T00:00:00",
            "endDate": "2024-01-07T00:00:00"
          }
        }
      ]
    }
  },  
  ...
}

Walley ⇨ Ingrid data mapping​

Walley checkout cart items propertiesIngrid request properties
idcart.items.sku (if sku is not present)
descriptioncart.items.name
unitPricecart.items.price
quantitycart.items.quantity
skucart.items.sku
shipping.tagscart.items.attributes
shipping.unitWeightcart.items.weight
shipping.dimensionscart.items.dimensions
shipping.shippingInterval.startDatecart.items.shipping_date.start
shipping.shippingInterval.endDatecart.items.shipping_date.end
shipping.shippingInterval.alternatives[].namecart.items.shipping_date.category_tags.name
shipping.shippingInterval.alternatives[].shippingInterval.startDatecart.items.shipping_date.category_tags.shipping_data.start
shipping.shippingInterval.alternatives[].shippingInterval.endDatecart.items.shipping_date.category_tags.shipping_data.end
Walley checkout shipping propertiesIngrid request properties
tagscart.attributes
shipments[].tagscart.groups.attributes
shipments[].idcart.groups.group_id
shipments[].contents[].skucart.groups.contents.sku
shipments[].contents[].quantitycart.groups.contents.quantity
shippingInterval.startDatecart.shipping_data.start
shippingInterval.endDatecart.shipping_data.end
shippingInterval.alternatives[].namecart.shipping_date.category_tags.name
shippingInterval.alternatives[].shippingInterval.startDatecart.shipping_date.category_tags.shipping_data.start
shippingInterval.alternatives[].shippingInterval.endDatecart.shipping_date.category_tags.shipping_data.end

Extending regular Walley API GET checkout response​

As with any delivery adapter walley provide information about the selected delivery when you get checkout information located in the shipping property. When using the Ingrid Adapter you will get additional data that you can find in the mapping tables below.

Walley provided shipping data​

Walley checkout propertiesWalley provided values
shipping.provider'Ingrid' or 'MerchantFallback'
shipping.shippingFeeTotal cost of all deliveries
shipping.shipments[]All of the data in each shippment (except feeItemId) is taken from the Ingrid session, and can be found in the table below.
shipping.shipments[].feeItemIdId for the shipping fee item

Ingrid ⇨ Walley data mapping​

Walley checkout shipment properties (found in shipping.shippments[])Ingrid delivery group properties (found in session.delivery_groups[])
idgroup_id
externalShipmentIdtos_id
metadata.customerDeliveryPromise.earliestdelivery_time.customer_delivery_promise.earliest
metadata.customerDeliveryPromise.latestdelivery_time.customer_delivery_promise.latest
metadata.carrierDeliveryPromise.earliestdelivery_time.carrier_delivery_promise.earliest
metadata.carrierDeliveryPromise.latestdelivery_time.carrier_delivery_promise.latest
metadata.pickupFromMerchant.earliestdelivery_time.pickup_from_merchant.earliest
metadata.pickupFromMerchant.latestdelivery_time.pickup_from_merchant.latest
shippingChoice.idshipping.carrier_product_id
shippingChoice.nameshipping.product (carrier used if product missing)
shippingChoice.feepricing.price / 100
shippingChoice.metadatashipping.meta
shippingChoice.destination.idaddress.location.external_id
shippingChoice.destination.nameaddress.location.name
shippingChoice.destination.metadata.address.addressLinesaddress.location.address.addressLines
shippingChoice.destination.metadata.address.apartmentNumberaddress.location.address.apartmentNumber
shippingChoice.destination.metadata.address.attnaddress.location.address.attn
shippingChoice.destination.metadata.address.careOfaddress.location.address.careOf
shippingChoice.destination.metadata.address.cityaddress.location.address.city
shippingChoice.destination.metadata.address.companyNameaddress.location.address.companyName
shippingChoice.destination.metadata.address.countryaddress.location.address.country
shippingChoice.destination.metadata.address.firstNameaddress.location.address.firstName
shippingChoice.destination.metadata.address.lastNameaddress.location.address.lastName
shippingChoice.destination.metadata.address.postalCodeaddress.location.address.postalCode
shippingChoice.destination.metadata.address.regionaddress.location.address.region
shippingChoice.destination.metadata.address.streetaddress.location.address.street
shippingChoice.destination.metadata.address.streetNumberaddress.location.address.streetNumber
shippingChoice.options[].idshipping.delivery_addons[].id
shippingChoice.options[].valueshipping.delivery_addons[].external_addon_id
shippingChoice.options[].feeshipping.pricing.price_components[].value

Example​

/*
GET /checkouts/1eec44b5-66d3-4058-a31f-3444229fb727 HTTP/1.1
Host: api.uat.walleydev.com // (Please note! Different hostname in production)
Authorization: Bearer bXlVc2VybmFtZTpmN2E1ODA4MGQzZTk0M2VmNWYyMTZlMDE...
*/

/* Response example */
{
    "id": "1eec44b5-66d3-4058-a31f-3444229fb727",
    "data": {
        "customer": { ... },
        ...,
        "status": "PurchaseCompleted",
        "order": {
            "totalAmount": 2757,
            "items": [
                {
                    "id": "10001",
                    "description": "A product description",
                    "unitPrice": 5,
                    "quantity": 1,
                    "vat": 25,
                    "sku": "Item one sku"
                },
                {
                    "id": "10002",
                    "description": "Item two",
                    "unitPrice": 2,
                    "quantity": 1,
                    "vat": 25,
                    "sku": "Item two sku"
                },
                {
                    "id": "Frakt-1",
                    "description": "PostNord - MyPack Home",
                    "unitPrice": 100,
                    "quantity": 1,
                    "vat": 25
                },
                {
                    "id": "Frakt-2",
                    "description": "PostNord - MyPack Home",
                    "unitPrice": 100,
                    "quantity": 1,
                    "vat": 25
                }
            ]
        },
        "shipping": {
            "provider": "Ingrid",
            "shippingFee": 210.0,
            "shipments": [
                {
                  "id": "shipment-1",
                  "externalShipmentId": "01GE6FJ2J52Z2NHRY17HDJ1977",
                  "feeItemId": "Frakt-1",
                  "metadata": { 
                    "customerDeliveryPromise": {
                      "earliest": "2024-01-01T00:00:00",
                      "latest": "2024-01-07T00:00:00"
                    },
                    "carrierDeliveryPromise": {
                      "earliest": "2024-01-01T00:00:00",
                      "latest": "2024-01-07T00:00:00"
                    },
                    "pickupFromMerchant": {
                      "earliest": "2024-01-01T00:00:00",
                      "latest": "2024-01-07T00:00:00"
                    }
                  },
                  "shippingChoice": {
                    "id": "pnl", 
                    "name": "PostNord - MyPack Home",
                    "fee": 100.0,  
                    "metadata": null,
                    "destination": {
                      "id": "location-external-id", 
                      "name": "Gothenburg", 
                      "metadata": {
                        "address": {
                          "addressLines": ["Street 1", "Street 2"],
                          "apartmentNumber": "1",
                          "attn": "",
                          "careOf": "",
                          "city": "City",
                          "companyName": "Company name",
                          "country": "SE",
                          "firstName": "First Name",
                          "lastName": "Last Name",
                          "postalCode": "12345",
                          "region": "Region",
                          "street": "Street 1",
                          "streetNumber": "1"
                        }
                      }
                    }
                  }
                },
                {
                  "id": "shipment-2",
                  "externalShipmentId": "01GE6FJ2J5D3QHTD57XX0B38TS",
                  "feeItemId": "Frakt-2",
                  "metadata": { ... },
                  "shippingChoice": {
                      "id": "pnl",
                      "name": "PostNord - MyPack Home",
                      "fee": 100.0,
                      "metadata": { ... },
                      "destination": { ... },
                      "options": [
                        {
                          "id": "b225eaee-c31d-4c30-b6cf-1770f1d208cd",
                          "value": "express",
                          "fee": 10
                        }
                      ]
                  }
                }
            ]
        },
        ...
    }
}