simplex-mercadopago-sdk 0.2.2 → 0.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0f93c33e7cd78a08d80d5ae16970df8b976319f2
-  data.tar.gz: 0c620b90e7e37e08ef246f4192938b25fec59464
+  metadata.gz: 6d4572d150e5adacbe8cd1fc2dd379b123a7a889
+  data.tar.gz: 3fe6ab4a85cd4aaee027f2af94e07aed60ddf81e
 SHA512:
-  metadata.gz: ea36182edf6ed287e110cf51d9bb65b5ef76c4a9ce66b02be4084552f121968d8340fd1e7a6a4525cd157bd0ba3d8d7ce346d3c6eb6db8cb811e853373b260d3
-  data.tar.gz: 348a5a30aab886c4a405a937f6b82f82b63ccbd8dc387ed6d4b7506242f6a1e90bfdcf39ce6025352ba1b44a735e3d7a8aec97c252f79db975ca3b38c4e8cd93
+  metadata.gz: e72f803e7326f6c361fec51cb86aa16eab3b17e9971bcf154473c9afca5077bf5a4df9d18ca3a56c9f422c8ae3997c81cdd967152c488e766b02d7e9e9e1e9c4
+  data.tar.gz: 06a82441ff2876a45144e9b09bde5f40cc2bb897827b9c3268fd86a45c7497235e9ab1bc540b8e4b925b1348d08f67aa9cb7a1c8a4c9ac2d941ac3d1317bd90a

data/Gemfile.lock

@@ -1,14 +1,14 @@
 PATH
   remote: .
   specs:
-    simplex-mercadopago-sdk (0.2.1)
+    simplex-mercadopago-sdk (0.3.4)
       json
 
 GEM
   remote: https://rubygems.org/
   specs:
     coderay (1.0.9)
-    json (1.8.1)
+    json (1.8.3)
     method_source (0.8.1)
     pry (0.9.12)
       coderay (~> 1.0.5)

data/README.md

@@ -1,14 +1,19 @@
 # MercadoPago SDK module for Payments integration
 
-* [Usage](#usage)
-* [Using MercadoPago Checkout](#checkout)
-* [Using MercadoPago Payment collection](#payments)
+* [Install](#install)
+* [Basic checkout](#basic-checkout)
+* [Customized checkout](#custom-checkout)
+* [Generic methods](#generic-methods)
 
-<a name="usage"></a>
-## Usage:
+<a name="install"></a>
+## Install
 
-1. Copy lib/mercadopago.rb to your project desired folder.
-2. Copy lib/cacert.pem to the same folder (for SSL access to MercadoPago APIs).
+```gem install mercadopago-sdk```
+
+<a name="basic-checkout"></a>
+## Basic checkout
+
+### Configure your credentials
 
 * Get your **CLIENT_ID** and **CLIENT_SECRET** in the following address:
     * Argentina: [https://www.mercadopago.com/mla/herramientas/aplicaciones](https://www.mercadopago.com/mla/herramientas/aplicaciones)
@@ -16,6 +21,7 @@
     * México: [https://www.mercadopago.com/mlm/herramientas/aplicaciones](https://www.mercadopago.com/mlm/herramientas/aplicaciones)
     * Venezuela: [https://www.mercadopago.com/mlv/herramientas/aplicaciones](https://www.mercadopago.com/mlv/herramientas/aplicaciones)
     * Colombia: [https://www.mercadopago.com/mco/herramientas/aplicaciones](https://www.mercadopago.com/mco/herramientas/aplicaciones)
+    * Chile: [https://www.mercadopago.com/mlc/herramientas/aplicaciones](https://www.mercadopago.com/mlc/herramientas/aplicaciones)
 
 ```ruby
 require 'mercadopago.rb'
@@ -23,18 +29,9 @@ require 'mercadopago.rb'
 $mp = MercadoPago.new('CLIENT_ID', 'CLIENT_SECRET')
 ```
 
-### Get your Access Token:
-
-```ruby
-$accessToken = $mp.getAccessToken()
-
-puts (accessToken)
-```
+### Preferences
 
-<a name="checkout"></a>
-## Using MercadoPago Checkout
-
-### Get an existent Checkout preference:
+#### Get an existent Checkout preference
 
 ```ruby
 preference = $mp.get_preference('PREFERENCE_ID')
@@ -42,18 +39,26 @@ preference = $mp.get_preference('PREFERENCE_ID')
 puts $preferenceResult
 ```
 
-### Create a Checkout preference:
+#### Create a Checkout preference
 
 ```ruby
-preferenceData = Hash["items" => Array(Array["title"=>"testCreate", "quantity"=>1, "unit_price"=>10.2, "currency_id"=>"ARS"])]
-    
-preference = $mp.create_preference(preferenceData)
+
+preference_data = {
+			"items": [
+				{
+					"title": "testCreate", 
+					"quantity": 1, 
+					"unit_price": 10.2, 
+					"currency_id": "ARS"
+				}
+			]
+		}
+preference = $mp.create_preference(preference_data)
 
 puts preference
 ```
-<a href="http://developers.mercadopago.com/documentacion/recibir-pagos#glossary">Others items to use</a>
 
-### Update an existent Checkout preference:
+#### Update an existent Checkout preference
 
 ```ruby
 preferenceDataToUpdate = Hash["items" => Array(Array["title"=>"testUpdated", "quantity"=>1, "unit_price"=>2])]
@@ -63,10 +68,9 @@ preferenceUpdate = $mp.update_preference("PREFERENCE_ID", preferenceDataToUpdate
 puts preferenceUpdate
 ```
 
-<a name="payments"></a>
-## Using MercadoPago Payment
+### Payments/Collections
 
-### Searching:
+#### Search for payments
 
 ```ruby    
 filters = Array["id"=>null, "site_id"=>null, "external_reference"=>null]
@@ -75,25 +79,16 @@ searchResult = $mp.search_payment(filters)
 
 puts searchResult
 ```
-<a href="http://developers.mercadopago.com/documentacion/busqueda-de-pagos-recibidos">More search examples</a>
-
-### Receiving IPN notification:
 
-* Go to **Mercadopago IPN configuration**:
-    * Argentina: [https://www.mercadopago.com/mla/herramientas/notificaciones](https://www.mercadopago.com/mla/herramientas/notificaciones)
-    * Brasil: [https://www.mercadopago.com/mlb/ferramentas/notificacoes](https://www.mercadopago.com/mlb/ferramentas/notificacoes)
-    * México: [https://www.mercadopago.com/mlm/herramientas/notificaciones](https://www.mercadopago.com/mlm/herramientas/notificaciones)
-    * Venezuela: [https://www.mercadopago.com/mlv/herramientas/notificaciones](https://www.mercadopago.com/mlv/herramientas/notificaciones)
-    * Colombia: [https://www.mercadopago.com/mco/herramientas/notificaciones](https://www.mercadopago.com/mco/herramientas/notificaciones)<br />
+#### Get payment data
 
 ```ruby
-
-paymentInfo = $mp.get_payment_info("ID")
+paymentInfo = $mp.get_payment("ID")
 
 puts paymentInfo
 ```
 
-### Cancel (only for pending payments):
+### Cancel (only for pending payments)
 
 ```ruby
 result = $mp.cancel_payment("ID");
@@ -102,7 +97,7 @@ result = $mp.cancel_payment("ID");
 puts result
 ```
 
-### Refund (only for accredited payments):
+### Refund (only for accredited payments)
 
 ```ruby
 result = $mp.refund_payment("ID");
@@ -110,4 +105,72 @@ result = $mp.refund_payment("ID");
 // Show result
 puts result
 ```
-<a href=http://developers.mercadopago.com/documentacion/devolucion-y-cancelacion>About Cancel & Refund</a>
+
+<a name="custom-checkout"></a>
+## Customized checkout
+
+### Configure your credentials
+
+* Get your **ACCESS_TOKEN** in the following address:
+    * Argentina: [https://www.mercadopago.com/mla/account/credentials](https://www.mercadopago.com/mla/account/credentials)
+    * Brazil: [https://www.mercadopago.com/mlb/account/credentials](https://www.mercadopago.com/mlb/account/credentials)
+    * Mexico: [https://www.mercadopago.com/mlm/account/credentials](https://www.mercadopago.com/mlm/account/credentials)
+    * Venezuela: [https://www.mercadopago.com/mlv/account/credentials](https://www.mercadopago.com/mlv/account/credentials)
+    * Colombia: [https://www.mercadopago.com/mco/account/credentials](https://www.mercadopago.com/mco/account/credentials)
+
+```ruby
+require 'mercadopago.rb'
+
+$mp = MercadoPago.new('ACCESS_TOKEN')
+```
+
+### Create payment
+
+```ruby
+$mp.post ("/v1/payments", payment_data);
+```
+
+### Create customer
+
+```ruby
+$mp.post ("/v1/customers", Hash["email" => "email@test.com"]);
+```
+
+### Get customer
+
+```ruby
+$mp.get ("/v1/customers/CUSTOMER_ID");
+```
+
+* View more Custom checkout related APIs in Developers Site
+    * Argentina: [https://labs.mercadopago.com.ar/developers](https://labs.mercadopago.com.ar/developers)
+    * Brazil: [https://labs.mercadopago.com.br/developers](https://labs.mercadopago.com.br/developers)
+    * Mexico: [https://labs.mercadopago.com.mx/developers](https://labs.mercadopago.com.mx/developers)
+    * Venezuela: [https://labs.mercadopago.com.ve/developers](https://labs.mercadopago.com.ve/developers)
+    * Colombia: [https://labs.mercadopago.com.co/developers](https://labs.mercadopago.com.co/developers)
+
+<a name="generic-methods"></a>
+## Generic methods
+You can access any other resource from the MercadoPago API using the generic methods:
+
+```ruby
+// Get a resource, with optional URL params. Also you can disable authentication for public APIs
+$mp.get ("/resource/uri", [params], [authenticate=true])
+
+// Create a resource with "data" and optional URL params.
+$mp.post ("/resource/uri", data, [params])
+
+// Update a resource with "data" and optional URL params.
+$mp.put ("/resource/uri", data, [params])
+
+// Delete a resource with optional URL params.
+$mp.delete ("/resource/uri", [params])
+```
+
+ For example, if you want to get the Sites list (no params and no authentication):
+
+```ruby
+$sites = $mp.get ("/sites", null, false)
+
+puts $sites
+```

data/Rakefile

@@ -1,4 +1,3 @@
-require 'bundler/gem_tasks'
 require 'rake/testtask'
 
 Rake::TestTask.new do |t|

data/examples/checkout-buttons/basic_preference/button.rb

@@ -7,7 +7,7 @@ class Button
 	
   def call(env)
 	mp = MercadoPago.new('CLIENT_ID', 'CLIENT_SECRET')
-	preferenceData = Hash["items" => Array(Hash["title"=>"sdk-ruby", "quantity"=>1, "unit_price"=>10.2, "currency_id"=>"ARS"])]
+	preferenceData = {"items" => ["title"=>"testCreate", "quantity"=>1, "unit_price"=>10.2, "currency_id"=>"ARS"]}
 	preference = mp.create_preference(preferenceData)
 	
 	html =  '<!doctype html>

data/examples/preapproval-payments/button.rb

@@ -7,7 +7,7 @@ class Button
 	
   def call(env)
 	mp = MercadoPago.new('CLIENT_ID', 'CLIENT_SECRET')
-	preapprovalPayment = Hash[
+	preapprovalPayment_data = Hash[
 		"payer_email" => "my_customer@my_site.com",
 	    "back_url" => "http://www.my_site.com",
 	    "reason" => "Monthly subscription to premium package",
@@ -22,7 +22,7 @@ class Button
 	    ]
 	]
 
-	preapprovalPaymentResult = mp.create_preference(preapprovalPayment)
+	preapprovalPayment = mp.create_preapproval_payment(preapprovalPayment_data)
 	
 	html =  '<!doctype html>
 			<html>
@@ -30,7 +30,7 @@ class Button
 					<title>MercadoPago SDK - Create Preapproval Payment and Show Subscription Example</title>
 				</head>
 			<body>
-				<a href="' + preapprovalPaymentResult['response']['init_point'] + '" name="MP-Checkout" class="orange-ar-m-sq-arall">Pay</a>
+				<a href="' + preapprovalPayment['response']['init_point'] + '" name="MP-Checkout" class="orange-ar-m-sq-arall">Pay</a>
 				<script type="text/javascript" src="http://mp-tools.mlstatic.com/buttons/render.js"></script>
 			</body>
 			</html>'

data/lib/mercadopago.rb

@@ -10,12 +10,19 @@ require 'uri'
 require 'net/https'
 require 'yaml'
 require File.dirname(__FILE__) + '/version'
+require 'ssl_options_patch'
 
 class MercadoPago
-	def initialize(client_id, client_secret, debug_logger=nil)
-		@client_id = client_id
-		@client_secret = client_secret
-		@rest_client = RestClient.new(debug_logger)
+	def initialize(*args)
+		if args.size < 1 or args.size > 2
+			raise "Invalid arguments. Use CLIENT_ID and CLIENT SECRET, or ACCESS_TOKEN"
+		end
+
+		@client_id = args.at(0) if args.size == 2
+		@client_secret = args.at(1) if args.size == 2
+		@ll_access_token = args.at(0) if args.size == 1
+
+		@rest_client = RestClient.new()
 		@sandbox = false
 	end
 
@@ -33,19 +40,23 @@ class MercadoPago
 
 	# Get Access Token for API use
 	def get_access_token
-		app_client_values = {
-			'grant_type' => 'client_credentials',
-			'client_id' => @client_id,
-			'client_secret' => @client_secret
-		}
+		if @ll_access_token
+			@ll_access_token
+		else
+			app_client_values = {
+				'grant_type' => 'client_credentials',
+				'client_id' => @client_id,
+				'client_secret' => @client_secret
+			}
 
-		@access_data = @rest_client.post("/oauth/token", build_query(app_client_values), RestClient::MIME_FORM)
+			@access_data = @rest_client.post("/oauth/token", build_query(app_client_values), RestClient::MIME_FORM)
 
-		if @access_data['status'] == "200"
-			@access_data = @access_data["response"]
-			@access_data['access_token']
-		else
-			raise @access_data.inspect
+			if @access_data['status'] == "200"
+				@access_data = @access_data["response"]
+				@access_data['access_token']
+			else
+				raise @access_data.inspect
+			end
 		end
 	end
 
@@ -184,6 +195,92 @@ class MercadoPago
 		@rest_client.get("/preapproval/" + id + "?access_token=" + access_token)
 	end
 
+	# Generic resource get
+	def get(uri, params = nil, authenticate = true)
+		if not params.class == Hash
+			params = Hash.new
+		end
+
+		if authenticate
+			begin
+				access_token = get_access_token
+			rescue => e
+				return e.message
+			end
+
+			params["access_token"] = access_token
+		end
+
+		if not params.empty?
+			uri << (if uri.include? "?" then "&" else "?" end) << build_query(params)
+		end
+
+		@rest_client.get(uri)
+	end
+
+	# Generic resource post
+	def post(uri, data, params = nil)
+		if not params.class == Hash
+			params = Hash.new
+		end
+
+		begin
+			access_token = get_access_token
+		rescue => e
+			return e.message
+		end
+
+		params["access_token"] = access_token
+
+		if not params.empty?
+			uri << (if uri.include? "?" then "&" else "?" end) << build_query(params)
+		end
+
+		@rest_client.post(uri, data)
+	end
+
+	# Generic resource put
+	def put(uri, data, params = nil)
+		if not params.class == Hash
+			params = Hash.new
+		end
+
+		begin
+			access_token = get_access_token
+		rescue => e
+			return e.message
+		end
+
+		params["access_token"] = access_token
+
+		if not params.empty?
+			uri << (if uri.include? "?" then "&" else "?" end) << build_query(params)
+		end
+
+		@rest_client.put(uri, data)
+	end
+
+	# Generic resource delete
+	def delete(uri, params = nil)
+		if not params.class == Hash
+			params = Hash.new
+		end
+
+		begin
+			access_token = get_access_token
+		rescue => e
+			return e.message
+		end
+
+		params["access_token"] = access_token
+
+		if not params.empty?
+			uri << (if uri.include? "?" then "&" else "?" end) << build_query(params)
+		end
+
+		@rest_client.delete(uri)
+	end
+
 	def build_query(params)
 		URI.escape(params.collect { |k, v| "#{k}=#{v}" }.join('&'))
 	end
@@ -194,16 +291,14 @@ class MercadoPago
 
 		MIME_JSON = 'application/json'
 		MIME_FORM = 'application/x-www-form-urlencoded'
-		API_BASE_URL = URI.parse('https://api.mercadolibre.com')
+		API_BASE_URL = URI.parse('https://api.mercadopago.com')
 
 		def initialize(debug_logger=nil)
 			@http = Net::HTTP.new(API_BASE_URL.host, API_BASE_URL.port)
 
 			if API_BASE_URL.scheme == "https" # enable SSL/TLS
 				@http.use_ssl = true
-				@http.ssl_version = :SSLv3 if @http.respond_to? :ssl_version
-				@http.verify_mode = OpenSSL::SSL::VERIFY_PEER
-				@http.ca_file = File.join(File.dirname(__FILE__), "cacert.pem")
+				@http.ssl_options = OpenSSL::SSL::OP_NO_SSLv3 # explicitly tell OpenSSL not to use SSL3
 			end
 
 			@http.set_debug_output debug_logger if debug_logger
@@ -243,5 +338,9 @@ class MercadoPago
 		def put(uri, data = nil, content_type=MIME_JSON)
 			exec("PUT", uri, data, content_type)
 		end
+		
+		def delete(uri, content_type=MIME_JSON)
+			exec("DELETE", uri, nil, content_type)
+		end
 	end
 end