{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"params":[],"method":"get"},"next":{"description":"","pages":[]},"title":"Integrating with Shopify with a Private App","type":"basic","slug":"integrating-with-shopify","excerpt":"","body":"[block:api-header]\n{\n  \"title\": \"Prerequisites\"\n}\n[/block]\nBefore you begin, you will need the following:\n1. An existing Apruve Merchant Account on either Apruve's test or production\n2. An Apruve API Key associated with your Apruve Merchant Account.\n3. A Shopify Store with a **private app** enabled.\n\nWhether you want do this on the test server or production server depends on which Apruve server you wish to integrate your Shopify store with. For more information, see [Accounts and Keys](doc:accounts-and-keys).\n\nIf you meet the prerequisites, you can skip the rest of this section and move onto Step 1 - otherwise, please follow the instructions below:\n\n### Creating a Merchant Account\n\nIf you want to integrate with Apruve's test or production (live) servers, you can [contact us to get started](https://www.apruve.com/get-started/). You will receive an email containing a link to confirm the account - you'll need to confirm it before you can move forward and use it. \n\nAfter your account is created, you can find your `merchant_id` from the settings page when logged in to Apruve.\n\n### Creating an API Key\n\nAfter you've created and confirmed your Merchant Account, you'll need to create an API Key.\n\nTo create an API Key on Apruve's test server, [click here](https://test.apruve.com/api_keys)\n\nTo create an API Key on Apruve's production server, [click here](https://app.apruve.com/api_keys)\n\nYou may be prompted to login before you reach the API Key creation page.\n\n### Creating a Shopify Private App\nIn order to integrate with your Shopify store, you will need to create a  private app from the Shopify admin. This creates an endpoint for external services, in this case Apruve, to access categories of your Shopify data that you specify. We recommend you have a single private app dedicated to Apruve, if you already happen to have a private app.\n\nVisit [this page](https://help.shopify.com/manual/apps/private-apps) for instructions on how to do this.\n\nNote that it does not matter what you name this app, just remember which private app you'd like to use with Apruve for later configuration.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"1. Install Apruve Payment Gateway\"\n}\n[/block]\nLog in to Apruve and navigate to settings. From there select \"Shopify Configuration\" on the side navigation bar.\n\n![Shopify Config](https://s3.amazonaws.com/apruve-documentation-resources/shopify_apruve_config.png)\n\nFind the link labeled \"Install Apruve Payment Gateway\" and follow it. Login with your Shopify Admin credentials and select \"Install payment provider\".\n\n![Install Payment Provider](https://s3.amazonaws.com/apruve-documentation-resources/shopify_install_payment_provider.png)\n[block:api-header]\n{\n  \"title\": \"2. Configure the Apruve Payment Gateway\"\n}\n[/block]\nIf you are not already on the Shopify payments settings page, navigate there by selecting \"Settings\" from the main Shopify admin panel, then \"Payments\". \n\nScroll down to the \"Alternative Payments\" section and select Apruve from the drop-down menu.\n\nThen enter your `merchant_id` and `api_key`. Consult the top of this page to learn how to find these if you are unsure.\n[block:api-header]\n{\n  \"title\": \"3. Configure your Shopify Admin App\"\n}\n[/block]\nWe need to enable read-access for a small subset of your Shopify data in order for Apruve to integrate with your store.\n\nFirst navigate to the Apps page in your Shopify Admin dashboard and select \"Manage private apps\" at the the bottom of the page.\n\n![Manage Private Apps](https://s3.amazonaws.com/apruve-documentation-resources/shopify_manage_private_apps.png)\n\nFrom there select the private app that you created earlier for Apruve.\n\nIn the section labeled \"Admin API\" find the section labeled \"ADMIN API PERMISSIONS\"\n\nApruve requires read access permissions to two groups: \"Fulfillment services\" and \"Orders, transactions and fulfillments\".\n\n![Admin Permissions](https://s3.amazonaws.com/apruve-documentation-resources/shopify_admin_permissions.png)\n[block:api-header]\n{\n  \"title\": \"4. Configure Apruve\"\n}\n[/block]\nFinally we are ready to associate Apruve with your Shopify store. Keep the page from step 3 open, as we will need some of the information on your private app configuration page.\n\nIn a separate window log into Apruve and navigate to the \"Shopify Configuration\" page as before. From their find the fields for Store URL, Shopify API Key, Shopify API Password, and Shopify Shared Secret.\n\nFor Store URL, enter the url of your store.\n\nFind the field \"API key\" in your Shopify private app configuration page. Click the clipboard button next to the text to copy the value. On the Apruve Shopify Configuration page, right click the text area under the field labeled \"Shopify API Key and select paste. Do this for the other two values.\n\n![Click To Copy](https://s3.amazonaws.com/apruve-documentation-resources/shopify_admin_api_prefs.png)\n\nSelect save and the configuration is complete!\n[block:api-header]\n{\n  \"title\": \"What's next?\"\n}\n[/block]\nYour connection between Apruve and your Shopify store will not be 100% final until an actual order is placed and we are able to verify the shared secret you entered in step 4 above. To avoid complications be certain that you've entered it correctly. You may reenter it on the Shopify Configuration page in Apruve vefore it is verified. \n\n![Pending Integration](https://s3.amazonaws.com/apruve-documentation-resources/shopify_pending_integration.png)\n\nAfter the first order is placed you will be able to see that it was verified successfully or not and have the option to correct it in the latter case \n\n![Valid Integration](https://s3.amazonaws.com/apruve-documentation-resources/shopify_valid_integration.png)\n\n**Other than that, you should be all set!**\nYour customers will now have the option to pay using an Apruve account during checkout.\n\n\n###Questions or Issues?###\nPlease feel free to let us know at <support:::at:::apruve.com> and we will be happy to help.","updates":[],"order":6,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5a04799391d7ee00344de070","project":"58b9e955fba7da250056ff86","version":{"version":"4.0","version_clean":"4.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["58b9e955fba7da250056ff8a","58b9e9e168a4a5190011dcc2","58b9ea1de87271190074c623","58b9f9df4022e60f00ae20af","58bda4f77181082500275455","58bda69b8bcd092f00e52862","58bda751b4e9640f00e4bdaf","58e800fabc0deb0f002801f3","5925bfd9504e5239003807f4","5925c026aef9fd27008525c0","5925c0e7dd71b51b00ccc329","592d872451a3e80f00eb4a1a","592d9539b9b6b91900569ea0","592d990a51a3e80f00eb4c25","592d9bf480832f0f00ddfa46","592d9d5051a3e80f00eb4e02","592dbd5cd97832190073d76a","598360d76050430034ef4e07","598363237c926c0028d2e420","598363755de0a1002049efad","598363c27c926c0028d2e442","59c15f2ebc639a0032f770f0"],"_id":"58b9e955fba7da250056ff89","releaseDate":"2017-03-03T22:08:21.880Z","__v":22,"createdAt":"2017-03-03T22:08:21.880Z","project":"58b9e955fba7da250056ff86"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Integrations","slug":"ecommerce-integrations","order":4,"from_sync":false,"reference":false,"_id":"598363755de0a1002049efad","project":"58b9e955fba7da250056ff86","version":"58b9e955fba7da250056ff89","isAPI":false,"createdAt":"2017-08-03T17:55:01.947Z","__v":0},"user":"59232ee4e465c11900921e8a","createdAt":"2017-11-09T15:51:47.089Z","githubsync":"","__v":0,"parentDoc":null,"updatedAt":"2018-04-09T18:45:39.662Z"}

Integrating with Shopify with a Private App


[block:api-header] { "title": "Prerequisites" } [/block] Before you begin, you will need the following: 1. An existing Apruve Merchant Account on either Apruve's test or production 2. An Apruve API Key associated with your Apruve Merchant Account. 3. A Shopify Store with a **private app** enabled. Whether you want do this on the test server or production server depends on which Apruve server you wish to integrate your Shopify store with. For more information, see [Accounts and Keys](doc:accounts-and-keys). If you meet the prerequisites, you can skip the rest of this section and move onto Step 1 - otherwise, please follow the instructions below: ### Creating a Merchant Account If you want to integrate with Apruve's test or production (live) servers, you can [contact us to get started](https://www.apruve.com/get-started/). You will receive an email containing a link to confirm the account - you'll need to confirm it before you can move forward and use it. After your account is created, you can find your `merchant_id` from the settings page when logged in to Apruve. ### Creating an API Key After you've created and confirmed your Merchant Account, you'll need to create an API Key. To create an API Key on Apruve's test server, [click here](https://test.apruve.com/api_keys) To create an API Key on Apruve's production server, [click here](https://app.apruve.com/api_keys) You may be prompted to login before you reach the API Key creation page. ### Creating a Shopify Private App In order to integrate with your Shopify store, you will need to create a private app from the Shopify admin. This creates an endpoint for external services, in this case Apruve, to access categories of your Shopify data that you specify. We recommend you have a single private app dedicated to Apruve, if you already happen to have a private app. Visit [this page](https://help.shopify.com/manual/apps/private-apps) for instructions on how to do this. Note that it does not matter what you name this app, just remember which private app you'd like to use with Apruve for later configuration. [block:api-header] { "type": "basic", "title": "1. Install Apruve Payment Gateway" } [/block] Log in to Apruve and navigate to settings. From there select "Shopify Configuration" on the side navigation bar. ![Shopify Config](https://s3.amazonaws.com/apruve-documentation-resources/shopify_apruve_config.png) Find the link labeled "Install Apruve Payment Gateway" and follow it. Login with your Shopify Admin credentials and select "Install payment provider". ![Install Payment Provider](https://s3.amazonaws.com/apruve-documentation-resources/shopify_install_payment_provider.png) [block:api-header] { "title": "2. Configure the Apruve Payment Gateway" } [/block] If you are not already on the Shopify payments settings page, navigate there by selecting "Settings" from the main Shopify admin panel, then "Payments". Scroll down to the "Alternative Payments" section and select Apruve from the drop-down menu. Then enter your `merchant_id` and `api_key`. Consult the top of this page to learn how to find these if you are unsure. [block:api-header] { "title": "3. Configure your Shopify Admin App" } [/block] We need to enable read-access for a small subset of your Shopify data in order for Apruve to integrate with your store. First navigate to the Apps page in your Shopify Admin dashboard and select "Manage private apps" at the the bottom of the page. ![Manage Private Apps](https://s3.amazonaws.com/apruve-documentation-resources/shopify_manage_private_apps.png) From there select the private app that you created earlier for Apruve. In the section labeled "Admin API" find the section labeled "ADMIN API PERMISSIONS" Apruve requires read access permissions to two groups: "Fulfillment services" and "Orders, transactions and fulfillments". ![Admin Permissions](https://s3.amazonaws.com/apruve-documentation-resources/shopify_admin_permissions.png) [block:api-header] { "title": "4. Configure Apruve" } [/block] Finally we are ready to associate Apruve with your Shopify store. Keep the page from step 3 open, as we will need some of the information on your private app configuration page. In a separate window log into Apruve and navigate to the "Shopify Configuration" page as before. From their find the fields for Store URL, Shopify API Key, Shopify API Password, and Shopify Shared Secret. For Store URL, enter the url of your store. Find the field "API key" in your Shopify private app configuration page. Click the clipboard button next to the text to copy the value. On the Apruve Shopify Configuration page, right click the text area under the field labeled "Shopify API Key and select paste. Do this for the other two values. ![Click To Copy](https://s3.amazonaws.com/apruve-documentation-resources/shopify_admin_api_prefs.png) Select save and the configuration is complete! [block:api-header] { "title": "What's next?" } [/block] Your connection between Apruve and your Shopify store will not be 100% final until an actual order is placed and we are able to verify the shared secret you entered in step 4 above. To avoid complications be certain that you've entered it correctly. You may reenter it on the Shopify Configuration page in Apruve vefore it is verified. ![Pending Integration](https://s3.amazonaws.com/apruve-documentation-resources/shopify_pending_integration.png) After the first order is placed you will be able to see that it was verified successfully or not and have the option to correct it in the latter case ![Valid Integration](https://s3.amazonaws.com/apruve-documentation-resources/shopify_valid_integration.png) **Other than that, you should be all set!** Your customers will now have the option to pay using an Apruve account during checkout. ###Questions or Issues?### Please feel free to let us know at <[email protected]> and we will be happy to help.