Suggest edit
Help us improve the documentation
Did you see wrong information and would you like us to explain something else or improve our manuals? Please leave your suggestions on GitHub.

Mercado Pago SDK module for Payments integration

Install

Plain

gem install mercadopago-sdk

Basic checkout

Configure your credentials

Ruby

require 'mercadopago.rb'

$mp = MercadoPago.new('ACCESS_TOKEN')

Preferences

Get an existent Checkout preference

Ruby

preference = $mp.get_preference('PREFERENCE_ID')

puts $preferenceResult

Create a Checkout preference

Ruby


preference_data = {
            "items": [
                {
                    "title": "testCreate",
                    "quantity": 1,
                    "unit_price": 10.2,
                    "currency_id": "COP"
                }
            ]
        }
preference = $mp.create_preference(preference_data)

puts preference

Update an existent Checkout preference

Ruby

preferenceDataToUpdate = Hash["items" => Array(Array["title"=>"testUpdated", "quantity"=>1, "unit_price"=>2])]

preferenceUpdate = $mp.update_preference("PREFERENCE_ID", preferenceDataToUpdate)

puts preferenceUpdate

Payments/Collections

Search for payments

Ruby

filters = Array["id"=>null, "site_id"=>null, "external_reference"=>null]

searchResult = $mp.search_payment(filters)

puts searchResult

Get payment data

Ruby

paymentInfo = $mp.get_payment("ID")

puts paymentInfo

Cancel (only for pending payments)

Ruby

result = $mp.cancel_payment("ID");

// Show result
puts result

Refund (only for accredited payments)

Ruby

result = $mp.refund_payment("ID");

// Show result
puts result

Customized checkout

Configure your credentials

Ruby

require 'mercadopago.rb'

$mp = MercadoPago.new('ACCESS_TOKEN')

Find all the information about your credentials in our. FAQs.

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");

Generic methods

You can access any other resource from the Mercado Pago 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

Your search returns no results.

Verifique a ortografia de termos de pesquisa ou teste com outras palavras-chave.