You can use Giftship's API to create multiple shipping address checkouts in Shopify from any platform.
\nSuccessfull responses will provide you with a checkout link that you can redirect the user to.
\nGiftship will calculate tax based on your configured settings within Giftships dashboard and your Shopify tax settings.
\nCurrently, shipping must be added manually. We will eventually make a shipping rate endpoint available.
\nMake a POST request to the API endpoint at using the provided format. Ensure to json encode your request body. For each address, a single shipping rate should be provided which matches the address.
\nFor large multi-address orders with greater than 10 addresses, after the initial request is made, you will need to make requests to the poll endpoint until the checkout is ready. It is recommended to not poll more often than 2-3 seconds in order to ensure you do not reach your API limit prematurely.
\nGenerate an API key in Gifship's settings page within Shopify Admin. Record your access token in a safe place, and ensure that you keep it a secret. Before making API calls, please ensure to enable API access on the same page you generate the token.
\nSet a X-Giftship-Access-Token header using the access token you generated in Giftship's dashboard with your request.
\ncurl -X POST \\\n https://giftship.app/api/checkout/ \\\n -H 'Content-Type: application/json' \\\n -H 'X-Giftship-Access-Token: YOUR_ACCESS_TOKEN_HERE' \\\n -H 'cache-control: no-cache' \\\n -d 'YOUR_POST_DATA_HERE'\n\nWhat errors and status codes can a user expect?
\nIf the request is good, you will receive a response in the following format, which you can then redirect the customer to the checkout_url in order to complete the checkout:
\n{\n \"status\": \"success\",\n \"id\": 142740652096,\n \"checkout_url\": \"https://giftship4.myshopify.com/6542327872/invoices/ef722fdde0d591a493bdb0645268fca0\",\n \"total_price\": \"158.58\"\n}\n\nThe request is malformed - use the information provided in the response and carefully examine the example request for exact format needed.
\nEither the access token is not present, or the token provided is invalid.
\nThere myshopify url provided does not currently have an active Giftship subscription.
\nYou will receive this error if you have not assigned shipping addresses to each of the parts of your order. Please follow the instructions in the response to ensure that your request has shipping addresses associated with each required object.
\nYou have used all of the available API requests for the month. Upgrade your account to increase your limit.
\nThe request is accepted, but API access is disabled for the account. Enable API access in Giftship's settings.
\nBasic Plan: 500 API requests / month
Standard Plan: 5000 API requests / month
Business Plan: unlimited API requests
Create a multiple shipping address checkout
\n","urlObject":{"protocol":"https","path":["api","checkout",""],"host":["giftship","app"],"query":[],"variable":[]}},"response":[{"id":"db0380f0-95af-4044-b142-456c8b187682","name":"Shipping Address Conflict","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"},{"key":"X-Giftship-Access-Token","value":"{{gs_access_token}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"myshopify_url\": \"giftship4.myshopify.com\",\n \"line_items\": [\n {\n \"variant_id\": 15377376673856,\n \"product_id\": 1559202398272,\n \"quantity\": 1,\n \"address\": {\n \"name\": \"John Smith\",\n \"address1\": \"111 Fake Avenue\",\n \"address2\": \"#100\",\n \"city\": \"Hollywood\",\n \"state\": \"California\",\n \"country\": \"United States\",\n \"zip\": \"90210\",\n \"phone\": \"123-456-7891\",\n \"company\": \"Fake Company\"\n },\n \"properties\": {\n \"Message\": \"Put your custom gift message here!\",\n \"Delivery Date\": \"02-31-2019\"\n }\n },\n {\n \"variant_id\": 15377370316864,\n \"product_id\": 1559201742912,\n \"quantity\": 1,\n \"address\": {\n \"name\": \"Jane Doe\",\n \"address1\": \"123 Test Street\",\n \"city\": \"Calgary\",\n \"state\": \"Alberta\",\n \"country\": \"Canada\",\n \"zip\": \"T2X1T9\"\n },\n \"properties\": {\n \"Message\": \"Happy birthday Jane Doe!\",\n \"Delivery Date\": \"03-21-2019\"\n }\n }\n ],\n \"shipping_lines\": [\n {\n \"name\": \"UPS 3 Day Ground\",\n \"price\": 3000,\n \"address\": {\n \"name\": \"Jane Doe\",\n \"address1\": \"123 Test Street\",\n \"city\": \"Calgary\",\n \"state\": \"Alberta\",\n \"country\": \"Canada\",\n \"zip\": \"T2X1T9\"\n }\n }\n ],\n \"note_attributes\": [\n {\n \"name\": \"Delivery Instructions\",\n \"value\": \"Please include the thank you note, and drop on their doorstep\",\n \"address\": {\n \"name\": \"John Smith\",\n \"address1\": \"111 Fake Avenue\",\n \"address2\": \"#100\",\n \"city\": \"Hollywood\",\n \"state\": \"California\",\n \"country\": \"United States\",\n \"zip\": \"90210\",\n \"phone\": \"123-456-7891\",\n \"company\": \"Fake Company\"\n }\n },\n {\n \"name\": \"Delivery Instructions\",\n \"value\": \"Please include a happy birthday card\",\n \"address\": {\n \"name\": \"Jane Doe\",\n \"address1\": \"123 Test Street\",\n \"city\": \"Calgary\",\n \"state\": \"Alberta\",\n \"country\": \"Canada\",\n \"zip\": \"T2X1T9\"\n }\n },\n {\n \"name\": \"note\",\n \"value\": \"Enter a note here to display on the recreated order\",\n \"address\": {\n \"name\": \"Jane Doe\",\n \"address1\": \"123 Test Street\",\n \"city\": \"Calgary\",\n \"state\": \"Alberta\",\n \"country\": \"Canada\",\n \"zip\": \"T2X1T9\"\n }\n },\n {\n \"name\": \"note\",\n \"value\": \"Enter a note here to display on the recreated order\",\n \"address\": {\n \"name\": \"Jane Doe\",\n \"address1\": \"123 Test Street\",\n \"city\": \"Calgary\",\n \"state\": \"Alberta\",\n \"country\": \"Canada\",\n \"zip\": \"T2X1T9\"\n }\n }\n ],\n \"note\": \"ENTER A NOTE FOR THE INITIAL ORDER HERE.\",\n \"customer_id\": 899845193792\n}"},"url":"https://giftship.app/api/checkout/"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Thu, 07 Feb 2019 06:45:33 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"POST"},{"key":"Access-Control-Max-Age","value":"3600"},{"key":"Access-Control-Allow-Headers","value":"X-Giftship-Access-Token, Content-Type, Transfer-Encoding, Accept-Encoding, Access-Control-Allow-Headers, Authorization, X-Requested-With"}],"cookie":[],"responseTime":null,"body":"[\n \"Shipping line count does not equal the amount of addresses in the order. Please ensure you set a shipping line for each address in the order.\"\n]"}],"_postman_id":"9d21bd7c-4fdd-48cc-b58b-bae473609ed0"},{"name":"Multi Address with Discounts","id":"af989ca8-916c-4b79-a991-4d9121e28d39","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth1","oauth1":{"basicConfig":[{"key":"token","value":"