The FinditParts Reseller API allows you to search parts inventory, create new FinditParts user accounts, and place orders on behalf of linked FinditParts users.
\nCreating FinditParts users require a name, email, shipping address, and payment method on file. The process for creating accounts occurs on a finditparts.com page but can be embedded in an iframe or the user can be redirected and redirected back upon completion.
\nOnce a FinditParts user is setup, API reseller clients can initiate new orders on behalf of FinditParts users that have been created by, or linked to, a API reseller client via a \"Customer Reference\" (see Create Reseller Customer Session method for more information).
Please contact us at api-support@finditparts.com and describe your intended use case for the FinditParts API and we will issue API JWT credentials associated with your FinditParts account. Once these credentials are issued, you can access them in your FinditParts account and use as described below in 'JWT Basics'.
\nUse the Authorization header in the format Bearer <JWT TOKEN>.
Requirements for generating each JWT:
\nHS256 algorithm.exp which should be as short as reasonable to prevent requests from being replayed.iss which should be set to your Reseller Client ID (provided by FinditParts).A basic signed JWT with the above is sufficient to authorize a request to the Product Search API or the Get Reseller Customer Session API but the Create Reseller Customer Session has some additional requirements below.
Example basic JWT payload:
\nJWT.sign({\n iss: \"acme-corp-sandbox\",\n exp: 1600903066,\n}, 'RESELLER_CLIENT_SECRET')\n=> \"eyJhbGciOiJIUIJ9.ey7ImludGVudCI6IlVTRVJfU0VUVVAiLCJyZWRpcm.Ot4lyrVNG5IdUk...\"\nGenerate a new short-lived token for each request where each token is used in the Authorization HTTP header in the format:
\nAuthorization: Bearer eyJhbGciOiJIUIJ9.ey7ImludGVudCI6IlVTRVJfU0VUVVAiLCJyZWRpcm.Ot4lyrVNG5IdUk...\nIn addition, when generating JWTs for the purpose of creating new sessions on behalf of customers, additional JWT headers and custom payload must be provided. Please see createResellerCustomerSession for documentation.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Getting Started","slug":"getting-started"},{"content":"Authorization","slug":"authorization"}],"owner":"12847304","collectionId":"3bf4b099-ab2a-44b7-bb67-1951b768bdf6","publishedId":"TVReeWcY","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"CF3201"},"publishDate":"2020-10-02T22:03:16.000Z"},"item":[{"name":"reseller customer sessions","item":[{"name":"Create Reseller Customer Session","id":"bcbb31c0-45f5-4ca9-a1bc-8b3b1fc086bb","request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Creates a new Reseller Customer Session with intent of USER_SETUP or NEW_ORDER.
\nReturns session details including redirect_url for embedding or redirecting.
\nEach Reseller Customer Session is generated on behalf of a \"Customer Reference\". A Customer Reference should be a unique handle to your customer which will then be linked to a FinditParts account. Common identifiers could be a user ID or an email. This is the reference you will use in the future to place orders on behalf of the linked FinditParts user from a USER_SETUP session.
\nEach session has an intent of either USER_SETUP or NEW_ORDER. You must complete a USER_SETUP session for each Customer Reference before performing a NEW_ORDER session.
\nUpon creation, a session will return a finditparts.com URL that should be embedded in an iframe on your site or redirected to for the customer to complete USER_SETUP or a NEW_ORDER.
The USER_SETUP session will prompt the user to create a FinditParts account along with payment details and shipping address or login to an existing FinditParts account. You may re-run a USER_SETUP session on a previously setup Customer Reference to modify payment details or shipping addresses.
\nThe NEW_ORDER session will prompt the user with an order summary including final cost and confirmation of payment and shipping details.
\nsub which should specify the Customer Reference.data payload matching one of following formats depending on intent of the session being created:To link and setup a customer reference you provide to a new or existing FinditParts user, you can create a USER_SETUP session by providing a data payload in the JWT of the following format:
Example JWT payload:
\nJWT.sign({\n sub: \"CUSTOMER_123\",\n iss: \"acme-corp-sandbox\",\n exp: 1600903066,\n data: {\n intent: \"USER_SETUP\",\n user: { firstname: '...', lastname: '...', email: '...', company: '...' }, // Optional to prefill form\n redirect_url: \"https://acmecorp.com/finditparts_setup_success\", // Optional to redirect upon completion, otherwise will postMessage\n }\n}, 'RESELLER_CLIENT_SECRET')\n=> \"eyJhbGciOiJIUIJ9.ey7ImludGVudCI6IlVTRVJfU0VUVVAiLCJyZWRpcm.Ot4lyrVNG5IdUk...\"\nIf redirect_url is provided, the following query parameters will be provided upon completion:
resolution=SUCCESS&customer_reference=XXX&reseller_customer_session_id=XXXresolution=FAILED&reason=XXX&customer_reference=XXX&reseller_customer_session_id=XXXTo place a new order on behalf of a previously setup Customer Reference, you can create a NEW_ORDER session by providing a data payload in the JWT of the following format:
Example JWT payload:
\nJWT.sign({\n sub: \"CUSTOMER_123\",\n iss: \"acme-corp-sandbox\",\n exp: 1600903066,\n data: {\n intent: \"NEW_ORDER\",\n line_items: [\n // Can specify line items by a finditparts_product_id, specific variant_id, or part_number and manufacturer\n {\n finditparts_product_id: \"<FinditParts product ID>\",\n quantity: <integer>,\n },\n {\n variant_id: \"<specific variant ID from Product Search>\",\n quantity: <integer>,\n },\n {\n part_number: \"<part number>\",\n manufacturer: \"<name of manufacturer to assist product identification>\",\n quantity: <integer>,\n },\n ...\n ],\n redirect_url: \"https://acmecorp.com/finditparts_setup_success\", // Optional to redirect upon completion, otherwise will postMessage\n }\n}, 'RESELLER_CLIENT_SECRET')\n=> \"eyJhbGciOiJIUIJ9.ey7ImludGVudCI6IlVTRVJfU0VUVVAiLCJyZWRpcm.Ot4lyrVNG5IdUk...\"\nIf redirect_url is provided, the following query parameters will be provided upon completion:
If no redirect_url is provided (iframe implementation), the following will postMessage to the parent iframe upon completion:
Error:\n{\n error: true,\n message: String\n}\n\nSuccess:\n{\n error: false,\n intent: String,\n resolution: String,\n reseller_customer_session_id: String,\n customer_reference: String,\n}\n/
\n","urlObject":{"path":["reseller_customer_sessions"],"host":["https://finditparts.com/api/v1"],"query":[],"variable":[]}},"response":[{"id":"075ef70e-85d9-4415-ad94-d599f1ed7916","name":"Create Reseller Customer Session - User Setup Session","originalRequest":{"method":"POST","header":[],"url":"https://finditparts.com/api/v1/reseller_customer_sessions"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"Cowboy"},{"key":"Date","value":"Fri, 02 Oct 2020 17:48:16 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Vary","value":"Accept-Encoding, Origin"},{"key":"Content-Encoding","value":"gzip"},{"key":"Etag","value":"W/\"4f699ce0f3d0275cc8efdec0ccb1f2f4\""},{"key":"Cache-Control","value":"max-age=0, private, must-revalidate"},{"key":"Set-Cookie","value":"_fip_session_build=BAh7BkkiD3Nlc3Npb25faWQGOgZFVEkiJTJiZDc1ZTY4NjkwZjk4MjJjMDZjMTBiMjYzYjg4OWRkBjsAVA%3D%3D--071ca8b126ae91e4d809b342b54223fa6bd2e2c2; domain=.finditparts.com; path=/; secure; HttpOnly; SameSite=Lax"},{"key":"X-Request-Id","value":"dedae746-b971-4641-a1bd-432972561d35"},{"key":"X-Runtime","value":"0.151565"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Via","value":"1.1 vegur"}],"cookie":[],"responseTime":null,"body":"{\n \"errno\": 0,\n \"reseller_customer_session\": {\n \"id\": \"6e11078e-dcbc-4e2f-a24f-07afeb197b64\",\n \"intent\": \"user_setup\",\n \"resolution\": \"pending\",\n \"order\": null,\n \"expires_at\": \"2020-10-02T18:48:16.000-07:00\",\n \"customer_reference\": \"USER_123\",\n \"redirect_url\": \"https://www.finditparts.com/reseller_customer_sessions/6e11078e-dcbc-4e2f-a24f-07afeb197b64\"\n }\n}"},{"id":"a81c63ae-6b27-4fdf-936e-e80d0395808f","name":"Create Reseller Customer Session - Start New Order","originalRequest":{"method":"POST","header":[],"url":"https://finditparts.com/api/v1/reseller_customer_sessions"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"Cowboy"},{"key":"Date","value":"Fri, 02 Oct 2020 18:19:39 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Vary","value":"Accept-Encoding, Origin"},{"key":"Content-Encoding","value":"gzip"},{"key":"Etag","value":"W/\"69eaab9e6e1f27f351a7e4e1084812bb\""},{"key":"Cache-Control","value":"max-age=0, private, must-revalidate"},{"key":"Set-Cookie","value":"_fip_session_build=BAh7BkkiD3Nlc3Npb25faWQGOgZFVEkiJWY3NGMyYWI1MWM2NTljMWNkMzY3NTAxMmI3YmE2Nzg3BjsAVA%3D%3D--1aacb602be6c16c6cff061dde2adf366cef2dcd6; domain=.finditparts.com; path=/; secure; HttpOnly; SameSite=Lax"},{"key":"X-Request-Id","value":"cd930b30-3e54-49cc-b4f6-8b3248e536de"},{"key":"X-Runtime","value":"1.498765"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Via","value":"1.1 vegur"}],"cookie":[],"responseTime":null,"body":"{\n \"errno\": 0,\n \"reseller_customer_session\": {\n \"id\": \"44708915-0ca9-4086-b826-83a562e30f94\",\n \"intent\": \"new_order\",\n \"resolution\": \"pending\",\n \"order\": {\n \"number\": \"F101658518\",\n \"state\": \"in_progress\",\n \"total\": \"4.87\",\n \"line_items\": [\n {\n \"quantity\": 1,\n \"amount\": \"1.92\",\n \"manufacturer\": \"HALDEX\",\n \"part_number\": \"10035\"\n }\n ],\n \"adjustments\": [\n {\n \"label\": \"Shipping (FedEx Ground)\",\n \"amount\": \"0.0\"\n },\n {\n \"label\": \"Handling Charge\",\n \"amount\": \"2.95\"\n },\n {\n \"label\": \"Tax (CA)\",\n \"amount\": \"0.0\"\n }\n ]\n },\n \"expires_at\": \"2020-10-02T19:19:38.000-07:00\",\n \"customer_reference\": \"USER_123\",\n \"redirect_url\": \"https://www.finditparts.com/reseller_customer_sessions/44708915-0ca9-4086-b826-83a562e30f94\"\n }\n}"}],"_postman_id":"bcbb31c0-45f5-4ca9-a1bc-8b3b1fc086bb"},{"name":"Get Reseller Customer Session","id":"0fdbba36-0430-46af-aaa5-4e6f8a34f30f","request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Returns status and details of a session.
\n","urlObject":{"path":["reseller_customer_sessions",":reseller_customer_session_id"],"host":["https://finditparts.com/api/v1"],"query":[],"variable":[{"id":"16568a60-1194-452d-9708-718c0dcab2ba","description":{"content":"(Required) Reseller Customer Session ID returned from create
\n","type":"text/plain"},"type":"string","value":"Returns a list of products matching part number provided. One of part_number or query parameter is required.
Exact part number to match
\n","type":"text/plain"},"key":"part_number","value":"General part search query
\n","type":"text/plain"},"key":"query","value":"