Otros medios de pago
Con Checkout Transparente de Mercado Pago, es posible ofrecer, ademĂĄs de tarjeta y Pix, pagos vĂa boleto bancario y pago en agencias de loterĂa.
Para obtener una lista detallada de todos los medios de pago disponibles para integraciĂłn, envĂa un GET con tu access_token
al endpoint /v1/payment_methods y ejecuta la solicitud o, si lo prefieres, haz la solicitud utilizando uno de nuestros SDKs.
<?php
use MercadoPago\MercadoPagoConfig;
MercadoPagoConfig::setAccessToken("ENV_ACCESS_TOKEN");
$client = new PaymentMethodClient();
$payment_method = $client->get();
?>
import { MercadoPagoConfig, PaymentMethods } from 'mercadopago';
const client = new MercadoPagoConfig({ accessToken: 'access_token' });
const paymentMethods = new PaymentMethods(client);
paymentMethods.get().then((result) => console.log(result))
.catch((error) => console.log(error));
MercadoPagoConfig.setAccessToken("ENV_ACCESS_TOKEN");
PaymentMethodClient client = new PaymentMethodClient();
client.list();
require 'mercadopago'
sdk = Mercadopago::SDK.new('ENV_ACCESS_TOKEN')
payment_methods_response = sdk.payment_methods.get()
payment_methods = payment_methods_response[:response]
using MercadoPago.Client.PaymentMethod;
using MercadoPago.Config;
using MercadoPago.Resource;
using MercadoPago.Resource.PaymentMethod;
MercadoPagoConfig.AccessToken = "ENV_ACCESS_TOKEN";
var client = new PaymentMethodClient();
ResourcesList<PaymentMethod> paymentMethods = await client.ListAsync();
import mercadopago
sdk = mercadopago.SDK("ACCESS_TOKEN")
payment_methods_response = sdk.payment_methods().list_all()
payment_methods = payment_methods_response["response"]
curl -X GET \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'Authorization: Bearer ENV_ACCESS_TOKEN' \
'https://api.mercadopago.com/v1/payment_methods' \
Para ofrecer pagos con boleto bancĂĄrio y/o pago en agencias de loterĂa, sigue las siguientes etapas.
Importar MercadoPago.js
Para realizar la integraciĂłn de Checkout Transparente , es necesario capturar los datos necesarios para procesar el pago.
Esta captura se realiza incluyendo la biblioteca MercadoPago.js en tu proyecto, seguida del formulario de pago. Utiliza el siguiente código para importar la biblioteca MercadoPago.js antes de añadir el formulario de pago.
<body>
<script src="https://sdk.mercadopago.com/js/v2"></script>
</body>
npm install @mercadopago/sdk-js
Configurar credenciales
Las credenciales son claves Ășnicas con las que identificamos una integraciĂłn en tu cuenta. Se utilizan para capturar pagos en tiendas online y otras aplicaciones de forma segura.
Esta es la primera etapa de una estructura de código completa que se debe seguir para integrar correctamente los pagos. Presta atención a los siguientes bloques para añadirlos a los códigos como se indica.
<script>
const mp = new MercadoPago("YOUR_PUBLIC_KEY");
</script>
import { loadMercadoPago } from "@mercadopago/sdk-js";
await loadMercadoPago();
const mp = new window.MercadoPago("YOUR_PUBLIC_KEY");
Añadir formulario de pago
Con la biblioteca MercadoPago.js incluida, añade el siguiente formulario de pago a tu proyecto para garantizar la captura segura de los datos de los compradores. En esta etapa es importante utilizar la lista que consultaste para obtener los medios de pago disponibles para crear las opciones de pago que deseas ofrecer.
<form id="form-checkout" action="/process_payment" method="post">
<div>
<h1>Payer Request</h1>
<div>
<label for="payerFirstName">Nome</label>
<input id="form-checkout__payerFirstName" name="payerFirstName" type="text">
</div>
<div>
<label for="payerLastName">Sobrenome</label>
<input id="form-checkout__payerLastName" name="payerLastName" type="text">
</div>
<div>
<label for="email">E-mail</label>
<input id="form-checkout__email" name="email" type="text">
</div>
<div>
<label for="identificationType">Tipo de documento</label>
<input id="form-checkout__identificationType" name="identificationType" type="text"></input>
</div>
<div>
<label for="identificationNumber">NĂșmero do documento</label>
<input id="form-checkout__identificationNumber" name="identificationNumber" type="text">
</div>
<div>
<label for="zip_code"> CEP: </label>
<input id="form-checkout__zip_code" name="zip_code" type="text">
</div>
<div>
<label for="street_name"> Rua: </label>
<input id="form-checkout__street_name" name="street_name" type="text">
</div>
<div>
<label for="street_number"> NĂșmero: </label>
<input id="form-checkout__street_number" name="street_number" type="text">
</div>
<div>
<label for="neighborhood"> Bairro: </label>
<input id="form-checkout__neighborhood" name="neighborhood" type="text">
</div>
<div>
<label for="city"> Cidade: </label>
<input id="form-checkout__city" name="city" type="text">
</div>
<div>
<label for="federal_unit"> Estado: </label>
<input id="form-checkout__federal_unit" name="federal_unit" type="text">
</div>
</div>
<div>
<div>
<input type="hidden" name="transactionAmount" id="transactionAmount" value="100">
<input type="hidden" name="description" id="description" value="Nome do Produto">
<br>
<button type="submit">Pagar</button>
</div>
</div>
</form>
Obtener tipos de documentos
Después de configurar la credencial y añadir el formulario de pago, es necesario obtener los tipos de documentos que se utilizarån para rellenar el formulario de pago.
Al incluir el elemento select
con el id: form-checkout__identificationType
que se encuentra en el formulario, serĂĄ posible completar automĂĄticamente las opciones disponibles al llamar la siguiente funciĂłn:
function createSelectOptions(elem, options, labelsAndKeys = { label : "name", value : "id"}){
const {label, value} = labelsAndKeys;
elem.options.length = 0;
const tempOptions = document.createDocumentFragment();
options.forEach( option => {
const optValue = option[value];
const optLabel = option[label];
const opt = document.createElement('option');
opt.value = optValue;
opt.textContent = optLabel;
tempOptions.appendChild(opt);
});
elem.appendChild(tempOptions);
}
// Get Identification Types
(async function getIdentificationTypes () {
try {
const identificationTypes = await mp.getIdentificationTypes();
const docTypeElement = document.getElementById('docType');
createSelectOptions(docTypeElement, identificationTypes)
}catch(e) {
return console.error('Error getting identificationTypes: ', e);
}
})()
Enviar pago
Al finalizar la inclusiĂłn del formulario de pago y obtener los tipos de documentos, es necesario enviar el email del comprador, el tipo y nĂșmero de documento, el medio de pago utilizado y el detalle del importe a pagar utilizando nuestra API de Pagos o uno de nuestros SDKs.
Para configurar pagos con boleto bancario o pago en agencia de loterĂa, envĂa un POST con los los parĂĄmetros indicados en las tablas debajo al endpoint /v1/payments y ejecuta la solicitud o, si lo prefieres, utiliza uno de nuestros SDKs indicados a continuaciĂłn.
<?php
use MercadoPago\Client\Payment\PaymentClient;
use MercadoPago\Client\Common\RequestOptions;
use MercadoPago\MercadoPagoConfig;
MercadoPagoConfig::setAccessToken("YOUR_ACCESS_TOKEN");
$client = new PaymentClient();
$request_options = new RequestOptions();
$request_options->setCustomHeaders(["X-Idempotency-Key: <SOME_UNIQUE_VALUE>"]);
$payment = $client->create([
"transaction_amount" => (float) $_POST['<TRANSACTION_AMOUNT>'],
"payment_method_id" => $_POST['<PAYMENT_METHOD_ID>'],
"payer" => [
"email" => $_POST['<EMAIL>'],
"first_name" => $_POST['<NOME>'],
"last_name" => $_POST['<SOBRENOME>'],
"identification" => [
"type" => $_POST['<TIPO DE DOCUMENTO>'],
"number" => $_POST['<NUMERO>']
],
"address" => [
"zip_code" => $_POST['<CEP>'],
"city" => $_POST['<CIDADE>'],
"street_name" => $_POST['<RUA>'],
"street_number" => $_POST['<NĂMERO>'],
"neighborhood" => $_POST['<BAIRRO>'],
"federal_unit" => $_POST['<SIGLA DO ESTADO>']
]
]
], $request_options);
echo implode($payment);
?>
import { MercadoPagoConfig, Payments } from 'mercadopago';
const client = new MercadoPagoConfig({ accessToken: '<YOUR_ACCESS_TOKEN>' });
const payments = new Payments(client);
payments.create({
body: {
transaction_amount: '<TRANSACTION_AMOUNT>',
payment_method_id: '<PAYMENT_METHOD_ID>',
payer: {
email: '<EMAIL>',
first_name: '<NOMBRE>',
last_name: '<APELLIDO>',
identification:{
type:'<TIPO DE DOCUMENTO>',
number:'<NUMERO_DOCUMENTO>'
},
address:{
zip_code: '<CEP>',
city: '<CIUDAD>',
neighborhood: '<BARRIO>',
street_name: '<CALLE>',
street_number: '<NĂMERO>',
federal_unit: '<SIGLA ESTADO>'
}
}
},
requestOptions: { idempotencyKey: '<SOME_UNIQUE_VALUE>' }
})
.then((result) => console.log(result))
.catch((error) => console.log(error));
PaymentCreateRequest paymentCreateRequest = PaymentCreateRequest.builder()
.transactionAmount(new BigDecimal("<TRANSACTION_AMOUNT>"))
.paymentMethodId("bolbradesco")
.payer(PaymentPayerRequest.builder()
.email("<EMAIL>")
.firstName("<NAME>")
.lastName("<LASTNAME>")
.identification(IdentificationRequest.builder()
.type("CPF")
.number("<NUMERO>")
.build())
.address(PaymentPayerAddressRequest.builder()
.streetName("<RUA XXX>")
.streetNumber("123")
.zipCode("<CEP>")
.federalUnit("<SIGLA DO ESTADO>")
.city("<CIDADE>")
.neighborhood("<BAIRRO>")
.build())
.build())
.build();
require 'mercadopago'
sdk = Mercadopago::SDK.new('ENV_ACCESS_TOKEN')
custom_headers = {
'x-idempotency-key': '<SOME_UNIQUE_VALUE>'
}
custom_request_options = Mercadopago::RequestOptions.new(custom_headers: custom_headers)
payment_request = {
transaction_amount: 100,
description: 'TĂtulo del producto',
payment_method_id: 'bolbradesco',
payer: {
email: 'PAYER_EMAIL',
first_name: 'Test',
last_name: 'User',
identification: {
type: 'DNI',
number: '19119119',
},
address: {
zip_code: '1264',
street_name: 'Av. Caseros',
street_number: '3039',
neighborhood: 'Parque Patricios',
city: 'Buenos Aires',
federal_unit: 'BA'
}
}
}
payment_response = sdk.payment.create(payment_request, custom_request_options)
payment = payment_response[:response]
MercadoPagoConfig.AccessToken = "<ENV_ACCESS_TOKEN>";
var request = new PaymentCreateRequest
{
TransactionAmount = 105,
Description = "<DESCRIPCIĂN>",
PaymentMethodId = "bolbradesco",
Payer = new PaymentPayerRequest
{
Email = "<EMAIL>",
FirstName = "<NOMBRE>",
LastName = "<APELLIDO>",
Identification = new IdentificationRequest
{
Type = "CPF",
Number = "<NUMERO DE CPF>",
},
Address = new PaymentPayerAddressRequest
{
ZipCode = "<CĂDIGO POSTAL>",
StreetName = "<CALLE XXX>",
City = "<CIUDAD>",
StreetNumber = "<NĂMERO>",
Neighborhood = "<BARRIO>",
FederalUnit = "<SIGLA DE ESTADO>",
}
},
};
var client = new PaymentClient();
Payment payment = await client.CreateAsync(request);
import mercadopago
sdk = mercadopago.SDK("ENV_ACCESS_TOKEN")
request_options = mercadopago.config.RequestOptions()
request_options.custom_headers = {
'x-idempotency-key': '<SOME_UNIQUE_VALUE>'
}
payment_data = {
"transaction_amount": 100,
"description": "TĂtulo del producto",
"payment_method_id": "bolbradesco",
"payer": {
"email": "PAYER_EMAIL",
"first_name": "Test",
"last_name": "User",
"identification": {
"type": "DNI",
"number": "19119119"
},
"address": {
"zip_code": "1264",
"street_name": "Av. Caseros",
"street_number": "3039",
"neighborhood": "Parque Patricios",
"city": "Buenos Aires",
"federal_unit": "BA"
}
}
}
payment_response = sdk.payment().create(payment_data, request_options)
payment = payment_response["response"]
accessToken := "{{ACCESS_TOKEN}}"
cfg, err := config.New(accessToken)
if err != nil {
fmt.Println(err)
return
}
client := payment.NewClient(cfg)
request := payment.Request{
TransactionAmount: 105,
PaymentMethodID: "bolbradesco",
Payer: &payment.PayerRequest{
Email: "{{EMAIL}}",
FirstName: "{{NOME}}",
LastName: "{{SOBRENOME}}",
Identification: &payment.IdentificationRequest{
Type: "{{TIPO DO DOCUMENTO}}",
Number: "{{NUMERO}}",
},
Address: &payment.AddressRequest{
ZipCode: "06233-200",
City: "Osasco",
Neighborhood: "Bonfim",
StreetName: "Av. das NaçÔes Unidas",
StreetNumber: "3003",
FederalUnit: "SP",
},
},
}
resource, err := client.Create(context.Background(), request)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(resource)
curl --location 'https://api.mercadopago.com/v1/payments' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ENV_ACCESS_TOKEN' \
--header 'X-Idempotency-Key: <SOME_UNIQUE_VALUE>' \
--header 'X-Product-Id: <SOME_UNIQUE_VALUE>' \
--data-raw '{
"transaction_amount": 100,
"description": "Titulo do produto",
"payment_method_id": "bolbradesco",
"payer": {
"email": "test_user_12345@testuser.com",
"first_name": "Test",
"last_name": "User",
"identification": {
"type": "CPF",
"number": "01234567890"
}
"address": {
"zip_code": "88000000",
"street_name": "Nombre de calle",
"street_number": "123",
"neighborhood": "Barrio",
"city": "Ciudad",
"federal_unit": "UF"
}
}
}'
- Campos obligatorios para pagos con boleto bancĂĄrio
ParĂĄmetro | Tipo | DescripciĂłn, valores posibles y ejemplos |
payment_method_id | string | MĂ©todo de pago. Para boleto, es siempre bolbradesco . |
address.zip_code | string | CĂłdigo postal. Ejemplo: 88000000 |
address.street_name | string | Nombre de la calle del comprador. Ejemplo: Rua da Abobrinha. |
address.street_number | string | NĂșmero de la direcciĂłn del comprador. Ejemplo: 1291 |
address.neighborhood | string | Barrio donde se ubica la direcciĂłn del comprador. Ejemplo: Copacabana. |
address.city | string | Ciudad donde vive el comprador. Ejemplo: RĂo de Janeiro. |
address.federal_unit | string | Sigla del Estado donde vive el comprador. SĂłlo se aceptan dos caracteres. Por ejemplo: RJ. |
- Campos obligatorios para pagos en agencias de loterĂa
ParĂĄmetro | Tipo | DescripciĂłn, valores posibles y ejemplos |
payment_method_id | string | MĂ©todo de pago. |
La respuesta mostrarĂĄ el status pendiente hasta que el comprador realice el pago. AdemĂĄs, en la respuesta a la solicitud, el parĂĄmetro external_resource_url
devolverĂĄ una URL que contiene las instrucciones para que el comprador realice el pago. Puedes redirigirlo a este mismo link para finalizar el flujo de pago.
[
{
...,
"id": 5466310457,
"status": "pending",
"status_detail": "pending_waiting_payment",
...,
"transaction_details": {
"net_received_amount": 0,
"total_paid_amount": 100,
"overpaid_amount": 0,
"external_resource_url": "https://www.mercadopago.com/mlb/payments/ticket/helper?payment_id=123456789&payment_method_reference_id= 123456789&caller_id=123456",
"installment_amount": 0,
"financial_institution": null,
"payment_method_reference_id": "1234567890"
}
}
]
Fecha de vencimiento
La fecha de vencimiento predeterminada para los pagos de boletos es de 3 dĂas. Opcionalmente, es posible cambiar esta fecha enviando el campo date_of_expiration
en la solicitud de creaciĂłn del pago, definiendo un plazo entre 1 y 30 dĂas a partir de la fecha de emisiĂłn del boleto.
Para cambiar la fecha de vencimiento, utilice uno de los cĂłdigos disponibles a continuaciĂłn.
$payment->date_of_expiration = "2020-05-30T23:59:59.000-04:00";
La fecha usa el formato ISO 8601: yyyy-MM-dd'T'HH:mm:ssz
date_of_expiration: "2020-05-30T23:59:59.000-04:00",
La fecha usa el formato ISO 8601: yyyy-MM-dd'T'HH:mm:ssz
payment.setDateOfExpiration("2020-05-30T23:59:59.000-04:00")
La fecha usa el formato ISO 8601: yyyy-MM-dd'T'HH:mm:ssz
date_of_expiration: '2020-05-30T23:59:59.000-04:00',
La fecha usa el formato ISO 8601: yyyy-MM-dd'T'HH:mm:ssz
paymentCreateRequest.DateOfExpiration = DateTime.Parse("2020-05-30T23:59:59.000-04:00");
La fecha usa el formato ISO 8601: yyyy-MM-dd'T'HH:mm:ssz
"date_of_expiration": "2020-05-30T23:59:59.000-04:00"
La fecha usa el formato ISO 8601: yyyy-MM-dd'T'HH:mm:ssz
"date_of_expiration": "2020-05-30T23:59:59.000-04:00",
El tiempo para la aprobaciĂłn del boleto es de hasta 2 horas hĂĄbiles. Por lo tanto, establezca la fecha de vencimiento en un mĂnimo de 3 dĂas para asegurarse de que se pague el pago.
Cancelar pago
Para evitar problemas de facturaciĂłn, es importante cancelar los pagos expirados. AdemĂĄs, ten en cuenta que es posible cancelar solo los pagos que estĂĄn pendientes o en proceso. Si un pago vence dentro de los 30 dĂas, la cancelaciĂłn es automĂĄtica y el estado final del pago serĂĄ "cancelado" o "expirado".
Para obtener mĂĄs informaciĂłn, consulte la secciĂłn Reembolsos y cancelaciones.
La fecha usa el formato ISO 8601: yyyy-MM-dd'T'HH:mm:ssz