Joining Sell 2 Recycle

Introduction

Our platform allows customers to compare prices amongst the top recycling businesses, this enables them to find the best price for their devices as well as feel comfortable they are choosing a reputable business to recycle with.

Need a Recycling Website

If you currently do not have a recycling website, we recommend WebDesires Mobile Phone Recycling System, which comes with integration for our platform making it seamless to join.

Integrations

It's simple to integrate your recycling website to Sell 2 Recycle's price comparrison engine and requires a few simple components:

1. Pricing Feed CSV File 
   A CSV file following specific requirements which we can fetch to update the pricing in our system.
2. Order postback endpoint
   When a customer places an order through us, we post the order information to your system.
3. Order updates API Integration
   When you update an order on your system we can recieve those updates through our API.

Pricing Feeds CSV

In order to add your pricing to our comparrison engine you will need to generate and supply a publically hosted and accessible CSV file to the specifications below, we fetch our feeds once every 10~ minutes.

All pricing on Sell 2 Recycle are directly controlled from the data in this CSV file, it is the merchants resposibility to ensure this data is correct and up to date and that any prices provided are honored where applicable.

When processing your feed we will only do some basic checks, that the product matches a product in our system, that the price is above 0 and formatted to 2 decimal places and that the network and GB is provided and correct.

Any issues we encounter while processing your feed can be seen from your dashboard. We store feeds for 60 days for the purpose of cross referencing and/or debugging.

Requests

We perform a HTTP GET request once every 10~ minutes for your feed file, please ensure your server does not block our IP or our User Agent below:

• IP: 78.129.150.3
• User Agent: Sell 2 Recycle

Feed Specifications

Your Feed must be a valid Comma-Seperated Values file and follow the below feed requirements, please ensure you read this documentation in full - you can use our feed tester at the bottom of this page to test your feed at any time.

Feed Parameters

Feed Tester

Use our handy feed tester below to check your feed with our system, it will return a list of any hard and soft failures and also some informative.

• HARD - An unrecoverable issue that will stop us from processing your feed. You must fix these issues.
• SOFT - An issue with a particular row in the feed, this will cause us to ignore the entry but we will continue processing the file - these may or may not need any attention.
• INFO - Unique to this feed tester - informative information such as 0 price products (which we ignore) and non matched products (which will require manual intervention).

Order Postback

Our order postback endpoint sends order information to you periodically using a JSON array. This section of the documentation details how this system works and how you will need to handle the endpoint and the data sent and how you need to respond.

There are two parts to this API:

1. Request:
   We send a payload to your endpoint for each order in our system that hasnt been received yet by your endpoint.
2. Response:
   Your endpoint should respond appropriately so that we know you have recieved and processed the data sent.

Example Request

Below is an example request from our server, this will be a JSON encoded array of all the order details, please see the request parameters for further details.

{
		 "payment_method": "bacs",
		 "bank_sortcode": "000000",
		 "bank_account_number": "00000000",
		 "paypal": "",
		 "payment_currency": "GBP",

		 "last_name": "Person",
		 "first_name": "Example",
		 "email": "example@sell2recycle.co.uk",
		 "number": "+00000000000",

		 "address_country": "United Kingdom",
		 "address_county": "My County",
		 "address_town": "My Town",
		 "address_line_1": "123 My Street",
		 "address_line_2": "",
		 "address_postcode": "WS122DY",

		 "manufacturer_name": "Samsung",
		 "product_name": "iPad Pro (2017) 12.9\" Wi-Fi 512 GB",
		 "product_id": "000000",
		 "condition": "working",
		 "network": "unlocked",
		 "quoted_price": 185.0,

		 "order_id": "f7a73750-fe53-4372-b278-6ed77e72d2a2",
		 "postage_type": "trade_in_pack"
}

Example Responses

Below is an example response that your server should respond on each request above, this informs us that you have or haven't processed our request, if you respond with an error or you do not respond we will resend the request periodically.

Successful Response

A JSON encoded array must be returned giving us your internal order_id and a result of "success", for example:

{"result": "success", "order_id": 581164}

Unsuccessful Response

You can if possible respond with an error response, for example:

{"result": "error", "reason": "Server Error - Could not insert record / try again"}

Request Parameters

Postback Tester

Enter your postback url below and we will send you a test postback and then confirm your response.

Order Updates

Our system provides the ability for customers to check their order status. Also customers may contact us directly about an order placed with us, so it is important that you provide us order updates from your system for key things as outlined in this document.

Endpoint URL

All requests should be a JSON encoded POST request to the below url:

Headers

As part of your request you will need to provide the following authorization header:

Request Parameters

Example Request

Below is an example request.

{
		 "status": "new_offer",
		 "merchant_order_id": "000000",
		 "reason": "Device condition does not match Good condition due to battery dead.",
		 "price": "120.50"
}

Example Responses

Below is an example responses for success and failure from our system.

Successful Response

A JSON encoded array with result of "success", for example:

{"result": "success"}

Unsuccessful Response

A JSON encoded array with result of "error" with a reason, for example:

{"result": "error", "reason": "Cannot find order id"}

Integration Checklist

Please follow this basic checklist step by step.

• Register with Sell 2 Recycle using our registration form and sign the documents e-mailed to you.
• Create your pricing feed.
• Test your pricing feed with our feed tester.
• Send us a link to your pricing feed so that we can begin testing and integration.
• Create your order postback endpoint.
• Test your order postback endpoint with our postback tester.
• Let us know that order postback is integrated.
• Create our order update endpoint.
• Let us know that the order update endpoint is integrated.
• We will send you your secure token.

Register with Sell 2 Recycle

Please fill in the form below to register your interest to join Sell 2 Recycle.