curl -G -X GET 'https://{URL}/api/v1/space/{SPACE_ID}/purchase/pricing' \
    --data-urlencode 'categoryId=8'  \
    --data-urlencode 'unitaryPriceInCts=100000'  \
    --data-urlencode 'unitaryCashPriceInCts=120000'  \
    --data-urlencode 'quantity=1'  \
    --data-urlencode 'equipmentType=PRODUCT'  \
    --data-urlencode 'trademark=YOURTRADEMARK'  \
    --data-urlencode 'shippingUnitaryCostInCts=3900'  \
    --data-urlencode 'shippingType=STORE'

{
   "CASH_IN_SINGLE_INSTALMENT":{ //type of purchase, CASH_IN_SINGLE_INSTALMENT
      "currents": [
         {
            // for rental will contain the amount of the access fee paid when creating the purchase
            "accessFee": {
               // all price are structured like this :
               "priceInCts": 0,
               "taxPriceInCts": 0,
               "taxExcludedPriceInCts": 0
            },
            // Total shipping price
            "shipping": {
               "priceInCts": 3900,
               "taxPriceInCts": 650,
               "taxExcludedPriceInCts": 3250
            },
            // Total price
            "price": {
               "priceInCts": 123900,
               "taxPriceInCts": 20650,
               "taxExcludedPriceInCts": 103250
            },
            // Included items
            "includedItems": [
               {
                  "description": "The description"
                  "frequencyInMonths": 12
                  "image": "https://media.mypangee.com/image.png "
                  "link": "https://media.mypangee.com/link.pdf"
                  "paymentMode": "OCCURRENCE"
                  "publicPriceInCts": 1234
                  "title": "Title"
               },
               ...
            ]
         }
      ],
      "minimalPriceWithDuration": {
         "accessFee": {
            "priceInCts": 0,
            "taxPriceInCts": 0,
            "taxExcludedPriceInCts": 0
         },
         "shipping": {
            "priceInCts": 3900,
            "taxPriceInCts": 650,
            "taxExcludedPriceInCts": 3250
         },
         "price": {
            "priceInCts": 123900,
            "taxPriceInCts": 20650,
            "taxExcludedPriceInCts": 103250
         },
         "includedItems": [...]
      },
      "durationsInMonth": [
         12
      ],
      "instalmentCounts": {}
   },
   "CASH_IN_SEVERAL_INSTALMENTS":{ //type of purchase, CASH_IN_SEVERAL_INSTALMENTS
      "currents": [
         {
            "accessFee": {
               "priceInCts": 0,
               "taxPriceInCts": 0,
               "taxExcludedPriceInCts": 0
            },
            "shipping": {
               "priceInCts": 3900,
               "taxPriceInCts": 650,
               "taxExcludedPriceInCts": 3250
            },
            "price": {
               "priceInCts": 123900,
               "taxPriceInCts": 20650,
               "taxExcludedPriceInCts": 103250
            },
            // Payment instalment count
            "instalmentCount": 3,
            // Customer first payment
            "firstPayment": {
               "priceInCts": 41300,
               "taxPriceInCts": 6883,
               "taxExcludedPriceInCts": 34417
            },
            // Customer other schedule payment
            "schedulePayment": {
               "priceInCts": 41300,
               "taxPriceInCts": 6883,
               "taxExcludedPriceInCts": 34417
            },
            "includedItems": [...]
         },
         {
            "accessFee": {
               "priceInCts": 0,
               "taxPriceInCts": 0,
               "taxExcludedPriceInCts": 0
            },
            "shipping": {
               "priceInCts": 3900,
               "taxPriceInCts": 650,
               "taxExcludedPriceInCts": 3250
            },
            "price": {
               "priceInCts": 123900,
               "taxPriceInCts": 20650,
               "taxExcludedPriceInCts": 103250
            },
            "instalmentCount": 4,
            "firstPayment": {
               "priceInCts": 30975,
               "taxPriceInCts": 5162,
               "taxExcludedPriceInCts": 25813
            },
            "schedulePayment": {
               "priceInCts": 30975,
               "taxPriceInCts": 5162,
               "taxExcludedPriceInCts": 25813
            },
            "includedItems": [...]
         }
      ],
      "minimalPriceWithDuration": {
         "accessFee": {
            "priceInCts": 0,
            "taxPriceInCts": 0,
            "taxExcludedPriceInCts": 0
         },
         "shipping": {
            "priceInCts": 3900,
            "taxPriceInCts": 650,
            "taxExcludedPriceInCts": 3250
         },
         "price": {
            "priceInCts": 123900,
            "taxPriceInCts": 20650,
            "taxExcludedPriceInCts": 103250
         },
         "instalmentCount": 4,
         "firstPayment": {
            "priceInCts": 30975,
            "taxPriceInCts": 5162,
            "taxExcludedPriceInCts": 25813
         },
         "schedulePayment": {
            "priceInCts": 30975,
            "taxPriceInCts": 5162,
            "taxExcludedPriceInCts": 25813
         },
         "includedItems": [...]
      },
      "durationsInMonth": [
         12
      ],
      // distinct instalment count available, only for CASH_IN_SEVERAL_INSTALMENTS, else empty
      "instalmentCounts": {
         "12": [3,4]
      }
   }
   "RENT_ ...":{ //type of purchase, can be RENT_PRODUCT_WITH_REDEMPTION, RENT_PRODUCT_WITHOUT_REDEMPTION
      "currents": [
         {
            "accessFee": {
               "priceInCts": 10090,
               "taxPriceInCts": 1682,
               "taxExcludedPriceInCts": 8408
            },
            // customer contribution, this will be paid with the first rent
            "customerContribution": {
               "priceInCts": 10000,
               "taxPriceInCts": 1667,
               "taxExcludedPriceInCts": 8333
            },
            // Duration in month for this price
            "durationInMonths": 12,
            // Total first monthly price (monthlyPayment + customer contribution)
            "firstMonthlyPayment": {
               "priceInCts": 23990,
               "taxPriceInCts": 3999,
               "taxExcludedPriceInCts": 19991
            },
            // Total monthly price
            "monthlyPayment": {
               "priceInCts": 13990,
               "taxPriceInCts": 2332,
               "taxExcludedPriceInCts": 11658
            },
            "includedItems": [...]
         },
         {
            "accessFee": {
               "priceInCts": 10090,
               "taxPriceInCts": 1682,
               "taxExcludedPriceInCts": 8408
            },
            "customerContribution": {
               "priceInCts": 10000,
               "taxPriceInCts": 1667,
               "taxExcludedPriceInCts": 8333
            },
            "durationInMonths": 24,
            "firstMonthlyPayment": {
               "priceInCts": 18090,
               "taxPriceInCts": 3015,
               "taxExcludedPriceInCts": 15075
            },
            "monthlyPayment": {
               "priceInCts": 8090,
               "taxPriceInCts": 1348,
               "taxExcludedPriceInCts": 6742
            },
            "includedItems": [...]
         },
         {
            "accessFee": {
               "priceInCts": 10090,
               "taxPriceInCts": 1682,
               "taxExcludedPriceInCts": 8408
            },
            "customerContribution": {
               "priceInCts": 10000,
               "taxPriceInCts": 1667,
               "taxExcludedPriceInCts": 8333
            },
            "durationInMonths": 36,
            "firstMonthlyPayment": {
               "priceInCts": 16360,
               "taxPriceInCts": 2727,
               "taxExcludedPriceInCts": 13633
            },
            "monthlyPayment": {
               "priceInCts": 6360,
               "taxPriceInCts": 1060,
               "taxExcludedPriceInCts": 5300
            },
            "includedItems": [...]
         },
         {
            "accessFee": {
               "priceInCts": 10090,
               "taxPriceInCts": 1682,
               "taxExcludedPriceInCts": 8408
            },
            "customerContribution": {
               "priceInCts": 10000,
               "taxPriceInCts": 1667,
               "taxExcludedPriceInCts": 8333
            },
            "durationInMonths": 48,
            "firstMonthlyPayment": {
               "priceInCts": 15030,
               "taxPriceInCts": 2505,
               "taxExcludedPriceInCts": 12525
            },
            "monthlyPayment": {
               "priceInCts": 5030,
               "taxPriceInCts": 838,
               "taxExcludedPriceInCts": 4192
            },
            "includedItems": [...]
         }
      ],
      // will be the minimal monthly price from the above nodes
      "minimalPriceWithDuration": {
         "accessFee": {
               "priceInCts": 10090,
               "taxPriceInCts": 1682,
               "taxExcludedPriceInCts": 8408
         },
         "customerContribution": {
               "priceInCts": 10000,
               "taxPriceInCts": 1667,
               "taxExcludedPriceInCts": 8333
         },
         "durationInMonths": 48,
         "firstMonthlyPayment": {
               "priceInCts": 15030,
               "taxPriceInCts": 2505,
               "taxExcludedPriceInCts": 12525
         },
         "monthlyPayment": {
               "priceInCts": 5030,
               "taxPriceInCts": 838,
               "taxExcludedPriceInCts": 4192
         },
         "includedItems": [...]
      },
      "durationsInMonth": [12,24,36,48],
      "instalmentCounts": {}
   }
}

curl -X GET 'https://{URL}/api/v1/space/{SPACE_ID}/purchase/pricing/externalReference/{externalReference}'

curl --request POST \
     --header "Content-Type: application/json" \
      https://${URL}/api/v1/space/${SPACE_ID}/purchase/pricing/shoppingcart? \
      --data  @- <<REQUEST_BODY
/* shopping cart items */
{
   "items": [
      {
         "equipmentType": "PRODUCT",
         "categoryId": "16",
         "unitaryPriceInCts": "100000",
         "unitaryCashPriceInCts": "123400",
         "quantity": "1",
         "trademark": "T",
         "shippingUnitaryCostInCts": "3900"
      },
      {
         "equipmentType": "ACCESSORY",
         "categoryExternalId" : "Mountain bike helmet",
         "unitaryPriceInCts": "5000",
         "unitaryCashPriceInCts": "6000",
         "quantity": "2",
         "trademark": "T",
         "shippingUnitaryCostInCts": "490"
      }
      ...
   ],
   "purchaseKind": "RENT_PRODUCT_WITH_REDEMPTION",
   "personType": "NATURAL"
}
REQUEST_BODY

{
   "CASH_IN_SINGLE_INSTALMENT": {
      "currents": [
         {
            "accessFee": {
               "priceInCts": 0,
               "taxPriceInCts": 0,
               "taxExcludedPriceInCts": 0
            },
            "shipping": {
               "priceInCts": 4880,
               "taxPriceInCts": 813,
               "taxExcludedPriceInCts": 4067
            },
            "price": {
               "priceInCts": 149345,
               "taxPriceInCts": 2813,
               "taxExcludedPriceInCts": 146532
            },
            // Included items
            "includedItems": [
               {
                  "description": "The description"
                  "frequencyInMonths": 12
                  "image": "https://media.mypangee.com/image.png "
                  "link": "https://media.mypangee.com/link.pdf"
                  "paymentMode": "OCCURRENCE"
                  "publicPriceInCts": 1234
                  "title": "Title"
               },
               ...
            ]
         }
      ],
      "minimalPriceWithDuration": {
         "accessFee": {
               "priceInCts": 0,
               "taxPriceInCts": 0,
               "taxExcludedPriceInCts": 0
         },
         "shipping": {
               "priceInCts": 4880,
               "taxPriceInCts": 813,
               "taxExcludedPriceInCts": 4067
         },
         "price": {
               "priceInCts": 149345,
               "taxPriceInCts": 2813,
               "taxExcludedPriceInCts": 146532
         },
         "includedItems": [...]
      },
      "durationsInMonth": [
         12
      ],
      "instalmentCounts": {}
   },
   "RENT_PRODUCT_WITH_REDEMPTION": {
      "currents": [
         {
            "accessFee": {
               "priceInCts": 3090,
               "taxPriceInCts": 515,
               "taxExcludedPriceInCts": 2575
            },
            "customerContribution": {
               "priceInCts": 10000,
               "taxPriceInCts": 1667,
               "taxExcludedPriceInCts": 8333
            },
            "durationInMonths": 12,
            "firstMonthlyPayment": {
               "priceInCts": 16560,
               "taxPriceInCts": 2761,
               "taxExcludedPriceInCts": 13799
            },
            "monthlyPayment": {
               "priceInCts": 6560,
               "taxPriceInCts": 1094,
               "taxExcludedPriceInCts": 5466
            },
            "includedItems": [...]
         },
         {
            "accessFee": {
               "priceInCts": 3090,
               "taxPriceInCts": 515,
               "taxExcludedPriceInCts": 2575
            },
            "customerContribution": {
               "priceInCts": 10000,
               "taxPriceInCts": 1667,
               "taxExcludedPriceInCts": 8333
            },
            "durationInMonths": 24,
            "firstMonthlyPayment": {
               "priceInCts": 14360,
               "taxPriceInCts": 2394,
               "taxExcludedPriceInCts": 11966
            },
            "monthlyPayment": {
               "priceInCts": 4360,
               "taxPriceInCts": 727,
               "taxExcludedPriceInCts": 3633
            },
            "includedItems": [...]
         },
         {
            "accessFee": {
               "priceInCts": 3090,
               "taxPriceInCts": 515,
               "taxExcludedPriceInCts": 2575
            },
            "customerContribution": {
               "priceInCts": 10000,
               "taxPriceInCts": 1667,
               "taxExcludedPriceInCts": 8333
            },
            "durationInMonths": 36,
            "firstMonthlyPayment": {
               "priceInCts": 13540,
               "taxPriceInCts": 2257,
               "taxExcludedPriceInCts": 11283
            },
            "monthlyPayment": {
               "priceInCts": 3540,
               "taxPriceInCts": 590,
               "taxExcludedPriceInCts": 2950
            },
            "includedItems": [...]
         }
      ],
      "minimalPriceWithDuration": {
         "accessFee": {
               "priceInCts": 3090,
               "taxPriceInCts": 515,
               "taxExcludedPriceInCts": 2575
         },
         "customerContribution": {
               "priceInCts": 10000,
               "taxPriceInCts": 1667,
               "taxExcludedPriceInCts": 8333
         },
         "durationInMonths": 36,
         "firstMonthlyPayment": {
               "priceInCts": 13540,
               "taxPriceInCts": 2257,
               "taxExcludedPriceInCts": 11283
         },
         "monthlyPayment": {
               "priceInCts": 3540,
               "taxPriceInCts": 590,
               "taxExcludedPriceInCts": 2950
         },
         "includedItems": [...]
      },
      "durationsInMonth": [
         12,
         24,
         36
      ],
      "instalmentCounts": {}
   }
}

curl --request POST \
     --header "Content-Type: application/json" \
      https://${URL}/api/v1/space/${SPACE_ID}/shoppingcart/addShoppingCart?
      target=${target}&
      --data  @- <<REQUEST_BODY
/* shopping cart items */
{
  "items" : [
    {
      /* the equipment category id ([values](#categories)) */
      "categoryId" : 123,
      /*
      the equipment category name as provided to Pangee.
      (either the categoryId or the categoryExternalId should be provided but not both)
      */
      "categoryExternalId" : "Mountain bike",
      /* the calculated checksum */
      "checksum" : "ABCD...",
      /* the equipment description */
      "description" : "description ...",
      /* the equipment state ([values](#equipmnet-state)) */
      "equipmentState" : "NEW",
      /* the equipment type ([values](#equipmnet-type)) */
      "equipmentType" : "PRODUCT",
      /* the equipment image */
      "image" : "https://logo.png",
      /* the equipment insurance code (see with Pangee) */
      "insurances" : [],
      /* the equipment link */
      "link" : "https://link",
      /* the equipment model */
      "model" : "MODEL",
      /* the equipment price in cts for RENT*/
      "priceInCts" : 123400,
      /* the equipment cash price in cts */
      "cashPriceInCts" : 145600,
      /* the equipment quantity */
      "quantity" : 1,
      /* the equipment reference */
      "reference" : "REF_123",
      /* the external reference (id, ean...) */
      "externalReference" : "EAN",
      /* the shipping delivery time in days */
      "shippingDeliveryTimeInDays" : 7,
      /* the shipping type */
      "shippingType" : "HOME_DELIVERY",
      /* the shipping unitary cost in cts */
      "shippingUnitaryCostInCts" : 3000,
      /* the equipment stock available (-1 is unlimited value) */
      "stock" : -1,
      /* the equipment trademark */
      "trademark" : "TRADEMARK"
    },
    ...
  ],
  /* the customer informations */
  "customer": {
        "lastName": "DUPONT",
        "firstName": "Michel",
        "birthDate": "1990-01-31",
        "deliveryPostalAddress":{
            "streetAddress": "15 rue de ...",
            "additionalStreetAddress": "",
            "postalCode": "12345",
            "locality": "TOULOUSE",
            "countryCode": "FR",
            "name": "Maison principale"
        },
        "billingPostalAddress": {
            "streetAddress": "12 rue ...",
            "additionalStreetAddress": "",
            "postalCode": "78945",
            "locality": "PARIS",
            "countryCode": "FR",
            "name": "Lieu de travail"
        },
        "email": "email@mypangee.com",
        "personType": "COMPANY",
        "companyName": "PANGEE",
        "companyIdentifier": "123456789",
        "customerCivility": "MR"
    },
    /* the purchase external ID */
    "purchaseExternalId": "1",
    /* The purchase kind */
    "purchaseKind": "RENT_PRODUCT_WITH_REDEMPTION",
    /* The rental duration */
    "durationInMonths": "24"
    /* The web target url on marketplace */
    "target": "SHOPPING_CART"
}
REQUEST_BODY



> Here is the php code for generating the checksum

```shell
$data = [
    'categoryId' => 8,
    'equipmentState' => 'NEW',
    'equipmentType' => 'PRODUCT',
    'image' => 'https://bigcorp.com/product.jpg',
    'link' => 'https://bigcorp.com/product.html',
    'model' => 'NICE PRODUCT',
    'priceInCts' => 437700,
    'cashPriceInCts' => 450700,
    'reference' => 'REFERENCE-123456',
    'shippingDeliveryTimeInDays' => 7,
    'shippingType' => 'HOME_DELIVERY',
    'shippingUnitaryCostInCts' => 3900,
    'trademark' => 'BIGCORP'
];

$vars = [
    $data['categoryId'],// or $data['categoryExternalId']
    $data['equipmentState'],
    $data['equipmentType'],
    $data['image'],
    $data['link'],
    $data['model'],
    $data['priceInCts'],
    $data['cashPriceInCts'],
    $data['reference'],
    $data['shippingDeliveryTimeInDays'],
    $data['shippingType'],
    $data['shippingUnitaryCostInCts'],
    $data['trademark']
];

$checksum = strtoupper(hash_hmac('sha512', join('&', $vars), pack("H*", "TOKEN")));

> Here is the javascript code for generating the checksum

var data = {
    categoryId: 8,
    equipmentState: 'NEW',
    equipmentType: 'PRODUCT',
    image: 'https://bigcorp.com/product.jpg',
    link: 'https://bigcorp.com/product.html',
    model: 'NICE PRODUCT',
    priceInCts: 437700,
    cashPriceInCts: 450700,
    reference: 'REFERENCE-123456',
    shippingDeliveryTimeInDays: 7,
    shippingType: 'HOME_DELIVERY',
    shippingUnitaryCostInCts: 3900,
    trademark: 'BIGCORP'
};


var vars = [
    data['categoryId'],
    data['equipmentState'],
    data['equipmentType'],
    data['image'],
    data['link'],
    data['model'],
    data['priceInCts'],
    data['cashPriceInCts'],
    data['reference'],
    data['shippingDeliveryTimeInDays'],
    data['shippingType'],
    data['shippingUnitaryCostInCts'],
    data['trademark']
];

var token = 'TOKEN';
var buffer = Buffer.from(token, "hex");
var hmac = crypto.createHmac('sha512', buffer);
var data = hmac.update(vars.join('&'));
var checksum = data.digest("hex").toUpperCase();

curl https://${URL}/api/v1/space/${SPACE_ID}/shoppingcart/add?
      categoryId=${categoryId}&
      checksum=${checksum}&
      cleanShoppingCart=${cleanShoppingCart}&
      description=${description}&
      equipmentState=${equipmentState}&
      equipmentType=${equipmentType}&
      image=${image}&
      insurances=${insurance}&
      link=${link}&
      model=${model}&
      priceInCts=${priceInCts}&
      cashPriceInCts=${cashPriceInCts}&
      quantity=${quantity}&
      reference=${reference}&
      shippingDeliveryTimeInDays=${shippingDeliveryTimeInDays}&
      shippingType=${shippingType}&
      shippingUnitaryCostInCts=${shippingUnitaryCostInCts}&
      stock=${stock}&
      target=${target}&
      trademark=${trademark}
      --request GET

 https://${URL}/api/v1/space/${SPACE_ID}/shoppingcart/addEquipment/externalReference?
     cleanShoppingCart=${cleanShoppingCart}&
     equipmentState=${equipmentState}&
     insurances=${insurance}&
     quantity=${quantity}&
     reference=${reference}&
     services=${services}&
     target=${target}}
     --request GET

 https://${URL}/api/v1/space/${SPACE_ID}/shoppingcart/addEquipment/internalReference?
      cleanShoppingCart=${cleanShoppingCart}&
      equipmentState=${equipmentState}&
      insurances=${insurance}&
      quantity=${quantity}&
      reference=${reference}&
        services=${services}&
      target=${target}}
    --request GET

curl  https://${URL}/api/v1/purchase/${PURCHASE_ID} \
      --request GET  \
      --header 'X-API-Token: ${TOKEN}'

curl  https://${URL}/api/v1/purchase/external/${EXTERNAL_ID} \
      --request GET  \
      --header 'X-API-Token: ${TOKEN}'

{
  // MyPangee purchase ID
  "id": "1321546",
  // Purchase kind, see below for the different purchase kinds
  "kind": "RENT_PRODUCT_WITH_REDEMPTION",
  // Purchase status, see below for the different purchase status
  "status": "WAITING_FOR_PAYMENT",
  // Purchase creation time UTC
  "dateCreation": "2018-01-01T20:00:00Z",
  // Purchase update time UTC
  "dateLastUpdate": "2018-01-10T21:10:00Z",
  // Only rental. UTC date at which the rental start (delivery date)
  "dateStart": "2018-01-01T20:00:00Z",
  // Only rental.UTC last day of rental
  "dateEnd": "2021-01-01T20:00:00Z",
  // Rental duraiton in months
  "durationInMonths": 48,
  // Retailer country
  "country": "FR",
  // Purchase currency
  "currency": "EUR",
  // The retailer purchase ID
  "externalId": "AAAA",
  // Purchase items - return detailed information if allowed
  "items": [
    {
      // purchase item id
      "id": "9879879",
      // product reference
      "reference": "DSMLKDSK",
      // your reference we setup in our system
      "externalReference": "AZERTY",
      // Unit price the customer paid for the product
      "sellingPrice": {
        // all price are structured like this :
        "priceInCts": 52190, // price paid by the customer
        "taxPriceInCts": 8698, // tax part in this price
        "taxExcludedPriceInCts": 43492 // price without taxes
      },
      // Equipment name
      "name": "Blue Beautiful Bike ",
      // Equipment model
      "model": "Model",
      // Equipment description
      "description": "The description",
      // Quantity of product
      "quantity": 3,
      // Purchase item kind (see below for all the product kind)
      "kind": "PRODUCT",
      // Product serial numbers, known only after delivery
      "serialNumber": "897987987"
    }
  ],
  // informations about the customer
  "customer": {
    // his email address
    "email": "test@mypangee.com",
    // Last name
    "lastName": "DUPONT",
    // First name
    "firstName": "Jean",
    // Phone number with country prefix
    "phoneNumber": "+33 5 61 84 79 96",
    // Type of customer, NATURAL or COMPANY
    "type": "NATURAL",
    // the customer delivery address
    "billingPostalAddress": {
      "streetAddress": "2 rue Lapeyrouse",
      "additionalStreetAddress": "",
      "postalCode": "31300",
      "locality": "TOULOUSE",
      "countryCode": "FR",
      "fullStreetAddress": "2 rue Lapeyrouse",
      "fullAddress": "2 rue Lapeyrouse 31300 TOULOUSE",
      "name": "Nom Entreprise"
    },
    "deliveryPostalAddress": {
      //same fields as the billingPostalAddress
    }
  },
  // details about the company where the customer ished to be delviered in case of a pickup delivery
  "deliveryTo": {
    //the company address, same fields as the adress in customer
    "address": {},
    //the company name
    "name": "Pickup place",
    // the company contact email
    "email": "bigcorp@bigcorp.com",
    // the company contact phone number
    "phoneNumber": "+33 5 61 84 79 96",
    //the company external id you can provide us
    "externalReference": "AZ123"
  },
  // informations about a purchase pricing
  "pricing": {
    // Customer contribution price
    "customerContributionPriceInCts": {
      "priceInCts": 0, // price in cents
      "taxPriceInCts": 0, // price tax in cents
      "taxExcludedPriceInCts": 0 // price without tax in cents
    },
    // Redemption price
    "redemptionPriceInCts": {
      "priceInCts": 0, // price in cents
      "taxPriceInCts": 0, // price tax in cents
      "taxExcludedPriceInCts": 0 // price without tax in cents
    },
    // Total customer monthly price
    "monthlyPriceInCts": {
      "priceInCts": 0, // price in cents
      "taxPriceInCts": 0, // price tax in cents
      "taxExcludedPriceInCts": 0 // price without tax in cents
    }
  },
  "url": [
    {
      // the url for updating some information about this purchase
      "rel": "update",
      "url": "https://..."
    }
  ],
  // billings related to the caller
  "billings": [
    {
      // the billing source
      "source": {
        "address": {
          //same fields as the billingPostalAddress
        },
        "name": "PANGEE - PLATEFORME",
        "externalReference": "",
        "email": "test@mypangee.com",
        "phoneNumber": "+33 (0)1 22 33 44 66",
        "identifier": "SIRET"
      },
      // the billing destination
      "destination": {
        "address": {
          //same fields as the billingPostalAddress
        },
        "name": "ENTREPRISE",
        "externalReference": "",
        "email": "bigcorp@bigcorp.com",
        "phoneNumber": "+33 (0)1 22 33 44 66",
        "identifier": "SIRET"
      },
      // The billing amount, in cts
      "price": {
        "priceInCts": 120000,
        "taxPriceInCts": 20000,
        "taxExcludedPriceInCts": 100000
      },
      "qualifier": "PAYMENT"
    }
  ]
}

curl  https://${URL}/api/v1/purchase/customer?
      email=${email}
      --request GET  \
      --header 'X-API-Token: ${TOKEN}'

[
  {
    // MyPangee purchase ID
    "id": "1321546",
    // Purchase kind, see below for the different purchase kinds
    "kind": "RENT_PRODUCT_WITH_REDEMPTION",
    // Purchase status, see below for the different purchase status
    "status": "WAITING_FOR_PAYMENT",
    // Purchase creation time UTC
    "dateCreation": "2018-01-01T20:00:00Z",
    // Purchase update time UTC
    "dateLastUpdate": "2018-01-10T21:10:00Z",
    // Only rental. UTC date at which the rental start (delivery date)
    "dateStart": "2018-01-01T20:00:00Z",
    // Only rental.UTC last day of rental
    "dateEnd": "2021-01-01T20:00:00Z",
    // Rental duraiton in months
    "durationInMonths": 48,
    // Retailer country
    "country": "FR",
    // Purchase currency
    "currency": "EUR",
    // The retailer purchase ID
    "externalId": "AAAA",
    // Purchase items - return detailed information if allowed
    "items": [
      {
        // purchase item id
        "id": "9879879",
        // product reference
        "reference": "DSMLKDSK",
        // your reference we setup in our system
        "externalReference": "AZERTY",
        // Unit price the customer paid for the product
        "sellingPrice": {
          // all price are structured like this :
          "priceInCts": 52190, // price paid by the customer
          "taxPriceInCts": 8698, // tax part in this price
          "taxExcludedPriceInCts": 43492 // price without taxes
        },
        // Equipment name
        "name": "Blue Beautiful Bike ",
        // Equipment model
        "model": "Model",
        // Equipment description
        "description": "The description",
        // Quantity of product
        "quantity": 3,
        // Purchase item kind (see below for all the product kind)
        "kind": "PRODUCT",
        // Product serial numbers, known only after delivery
        "serialNumber": "897987987"
      }
    ],
    // informations about the customer
    "customer": {
      // his email address
      "email": "test@mypangee.com",
      // Last name
      "lastName": "DUPONT",
      // First name
      "firstName": "Jean",
      // Phone number with country prefix
      "phoneNumber": "+33 5 61 84 79 96",
      // Type of customer
      "type": "NATURAL",
      // the customer delivery address
      "billingPostalAddress": {
        "streetAddress": "2 rue Lapeyrouse",
        "additionalStreetAddress": "",
        "postalCode": "31300",
        "locality": "TOULOUSE",
        "countryCode": "FR",
        "fullStreetAddress": "2 rue Lapeyrouse",
        "fullAddress": "2 rue Lapeyrouse 31300 TOULOUSE",
        "name": "Nom Entreprise"
      },
      "deliveryPostalAddress": {
        //same fields as the billingPostalAddress
      }
    },
    // details about the company where the customer ished to be delviered in case of a pickup delivery
    "deliveryTo": {
      //the company address, same fields as the adress in customer
      "address": {},
      //the company name
      "name": "Pickup place",
      // the company contact email
      "email": "bigcorp@bigcorp.com",
      // the company contact phone number
      "phoneNumber": "+33 5 61 84 79 96",
      //the company external id you can provide us
      "externalReference": "AZ123"
    },
    // informations about a purchase pricing
    "pricing": {
      // Customer contribution price
      "customerContributionPriceInCts": {
        "priceInCts": 0, // price in cents
        "taxPriceInCts": 0, // price tax in cents
        "taxExcludedPriceInCts": 0 // price without tax in cents
      },
      // Redemption price
      "redemptionPriceInCts": {
        "priceInCts": 0, // price in cents
        "taxPriceInCts": 0, // price tax in cents
        "taxExcludedPriceInCts": 0 // price without tax in cents
      },
      // Total customer monthly price
      "monthlyPriceInCts": {
        "priceInCts": 0, // price in cents
        "taxPriceInCts": 0, // price tax in cents
        "taxExcludedPriceInCts": 0 // price without tax in cents
      }
    },
    "url": [
      {
        // the url for updating some information about this purchase
        "rel": "update",
        "url": "https://..."
      }
    ],
    // billings related to the caller
    "billings": [
      {
        // the billing source
        "source": {
          "address": {
            //same fields as the billingPostalAddress
          },
          "name": "PANGEE - PLATEFORME",
          "externalReference": "",
          "email": "test@mypangee.com",
          "phoneNumber": "+33 (0)1 22 33 44 66",
          "identifier": "SIRET"
        },
        // the billing destination
        "destination": {
          "address": {
            //same fields as the billingPostalAddress
          },
          "name": "ENTREPRISE",
          "externalReference": "",
          "email": "bigcorp@bigcorp.com",
          "phoneNumber": "+33 (0)1 22 33 44 66",
          "identifier": "SIRET"
        },
        // The billing amount, in cts
        "price": {
          "priceInCts": 120000,
          "taxPriceInCts": 20000,
          "taxExcludedPriceInCts": 100000
        },
        "qualifier": "PAYMENT"
      }
    ]
  }
]

curl  https://${URL}/api/v1/purchase?
      spaceId=${spaceId}&
      status=${status}&
      dateCreationStart=${dateCreationStart}&
      dateCreationEnd=${dateCreationEnd}&
      deliveryCompanyExternalReference=${deliveryCompanyExternalReference}
      --request GET  \
      --header "X-API-Token: ${TOKEN}"

[
  {
    "id": "12311", //MyPangee purchase ID
    // purchase status, you can look below for the
    // status details
    "status": "WAITING_FOR_PAYMENT",
      // Purchase creation time UTC
    "dateCreation": "2018-01-01T20:00:00Z",
    // Purchase update time UTC
    "dateLastUpdate": "2018-01-10T21:10:00Z",
    // the API url you can call to get more informations
    // about this purchase
    "url": [
        {
          // With rel=information this is URL for getting the
          // purchase items , customer details ....
          "rel" : "information",
          "url" : "https://..."
        },
        {
          // With rel=update this is the URL for updating a
          // purchase (external id, serial numbers)
          "rel" : "update",
          "url" : "https://..."
        }
        //more url will be added as we add API
    ],
    // Your purchase ID you sent us using the
    // purchase update api
    "externalId": "eazazeaze"
  },
  ...
]

curl --request POST \
     --header "X-API-Token: ${TOKEN}" \
     --header "Content-Type: application/json" \
    https://${URL}/api/v1/purchase/${PURCHASE_ID} \
    --data  @- <<REQUEST_BODY
{
  /* your shopping cart item */
  "externalId" :"AAAA",
  "items": [
    {

      /* the purchase item id */
      "id":"7548",
      /* your own product reference */
      "externalReference" : "YYYY",
      /* your purchase item serial number, used in contract. Only for products. */
      "serialNumber":"AAAAA"
    }
  ]
}
REQUEST_BODY

curl --request POST \
     --header "X-API-Token: ${TOKEN}" \
     --header "Content-Type: application/json" \
    https://${URL}/api/v1/purchase/${PURCHASE_ID}/comment?message={text} \

curl --request POST \
     --header "X-API-Token: ${TOKEN}" \
     --header "Content-Type: application/json" \
    https://${URL}/api/v1/purchase/${PURCHASE_ID}/addDeliveryTrackingUrl?deliveryTrackingUrl={text} \

curl --request POST \
     --header "X-API-Token: ${TOKEN}" \
     --header "Content-Type: application/json" \
    https://${URL}/api/v1/purchase/external/${EXTERNAL_ID}/addDeliveryTrackingUrl?deliveryTrackingUrl={text} \

curl --request POST \
     --header "X-API-Token: ${TOKEN}" \
     --header "Content-Type: application/json" \
    https://${URL}/api/v1/purchase/${PURCHASE_ID}/deliver \
    --data  @- <<REQUEST_BODY
{
  /* Delivery date respecting the pattern "yyyy-MM-dd" */
  "deliveryDate": "date",
  /* List of purchase detail item */
  "items": [
    {
        "quantity": 2,
        "id": 123456, /* Item id or your externalReference id */
        "serialNumbers": [
            "serial1",
            "serial2"
        ]
    },
    {
        "quantity": 1,
        "externalReference": "987654",
        "serialNumbers": [
            "serial"
        ]
    }
  ]
}
REQUEST_BODY

curl --request POST \
     --header "X-API-Token: ${TOKEN}" \
     --header "Content-Type: application/json" \
    https://${URL}/api/v1/purchase/external/${EXTERNAL_ID}/deliver \
    --data  @- <<REQUEST_BODY
{
  /* Delivery date respecting the pattern "yyyy-MM-dd" */
  "deliveryDate": "date",
  /* List of purchase detail item */
  "items": [
    {
        "quantity": 2,
        "id": 123456, /* Item id or your externalReference id */
        "serialNumbers": [
            "serial1",
            "serial2"
        ]
    },
    {
        "quantity": 1,
        "externalReference": "987654",
        "serialNumbers": [
            "serial"
        ]
    }
  ]
}
REQUEST_BODY

curl --request POST \
     --header "X-API-Token: ${TOKEN}" \
     --header "Content-Type: application/json" \
    https://${URL}/api/v1/purchase/${PURCHASE_ID}/sendRetailerInvoice?invoiceId={text} \
    --data "attachedFile=@/path/to/invoicefilename"

curl --request POST \
     --header "X-API-Token: ${TOKEN}" \
     --header "Content-Type: application/json" \
    https://${URL}/api/v1/purchase/external/${EXTERNAL_ID}/sendRetailerInvoice?invoiceId={text} \
    --data "attachedFile=@/path/to/invoicefilename"

curl https://${WEBHOOK_URL} \
      --request POST \
      --header "Accept: application/json" \
      --data @- << EOF
      {
        "id": "12311", //MyPangee purchase ID
        // purchase status, you can look below for the
        // status details
        "status": "WAITING_FOR_PAYMENT",
          // Purchase creation time UTC
        "dateCreation": "2018-01-01T20:00:00Z",
        // Purchase update time UTC
        "dateLastUpdate": "2018-01-10T21:10:00Z",
        // the API url you can call to get more informations
        // about this purchase
        "url": [
            {
              // With rel=information
              //this is URL for getting the purchase items , customer details ....
              "rel" : "information",
              "url" : "https://..."
            },
            {
              // With rel=informationWithExternalId
              // this is URL for getting the purchase items , customer details .... with externalId
              "rel" : "informationWithExternalId",
              "url" : "https://..."
            },
            {
              // With rel=update
              // this is the URL for updating a purchase (external id, serial numbers)
              "rel" : "update",
              "url" : "https://..."
            },
            {
              // With rel=customer
              // this is url for the customer account space
              "rel" : "customer",
              "url" : "https://..."
            }
            //more url will be added as we add API
        ],
        // Your purchase ID you sent us using the
        // purchase update api
        "externalId": "eazazeaze"
      }
      EOF

curl https://${URL}/api/v1/space/${SPACE_ID}/equipment/externalReference/${REFERENCE}
      --request GET

curl https://${URL}/api/v1/space/${SPACE_ID}/equipment/internalReference/${REFERENCE}
      --request GET

curl -G -X GET 'https://{URL}/api/v1/space/{SPACE_ID}/equipment/insurance' \
    --data-urlencode 'categoryId=8'  \
    --data-urlencode 'quantity=1'  \
    --data-urlencode 'productPriceInCts=123400'

[
    {
        "pricings": {
            ... // see to the Get Price part
        },
        "insurancePack": {
            "id": 88,
            "code": "DKT_ASSISTANCE_AXA_50",
            "name": "Assistance 50 km ",
            "description": "",
            "image": "https://static.mypangee.com/images/logos/logo-sans-label.png",
            "option": true
        },
        "insuranceKinds": [
            "ASSISTANCE" // See on parameters part
        ],
        "id": 88,
        "minimalPricePurchaseKind": "RENT_PRODUCT_WITH_REDEMPTION",
        "minimalPrice": {
            ...
        }
    },
    ...
]

curl -G -X GET 'https://{URL}/api/v1/space/{SPACE_ID}/equipment/additionalService' \
    --data-urlencode 'categoryId=8'  \
    --data-urlencode 'quantity=1'

[
    {
        "pricings": {
             ... // see to the Get Price part
        },
        "additionalService": {
            "id": 113,
            "name": "FORFAIT ENTRETIEN",
            "description": "Prestation de main d'oeuvre ...",
            "publicPriceInCts": 4600,
            "sellingPriceInCts": 4784,
            "frequencyInMonths": 12, // frequency in months
            "image": "https://media.mypangee.com/image.png",
            "technicalDataSheetUrl": "http://media.mypangee.com/file.pdf", // link to the tehcnical document
            "paymentMode": "OCCURRENCE",  // See on parameters part
            "externalCode": "external_code", // retialer code
            "internalCode": "internal Code", // mypangee code
            "company": ""
        },
        "id": 113,
        "minimalPricePurchaseKind": "RENT_PRODUCT_WITH_REDEMPTION",
        "minimalPrice": {
            ...
        }
    }
    ...
]