Mercado Pago

Esta documentación describe la integración de Portal Carat con la plataforma de pago de Mercado Pago. Además de explicar los ajustes que necesariamente se deben realizar en el entorno de Portal Carat.

Interfaces Portal Carat apoyo a la integración

Puede utilizar las siguientes interfaces para la integración con el enrutamiento de Mercado Pago:

• pago HTML

Credenciales requeridas

La tienda debe obtenerla del portal de Mercado Pago las credenciales que se enumeran a continuación y transmítalas a Software Express o regístrese en el Portal del Merchant de Portal Carat.

Parámetro	Descripción	Obligatorio
public_key	La clave pública de la aplicación para conocer, por ejemplo, el medio de pago y para encriptar los datos de la tarjeta.	SI
access_token	Clave privada de la aplicación para generar pagos.	SI

Códigos de autorizador

A continuación se muestran los códigos que se utilizarán en esta integración:

• 440: FOTO
• 402: otros métodos de pago con Mercado Pago

Atención: En el entorno de aprobación de Mercado Pago, no es posible simular una transacción PIX aprobada. La transacción estará pendiente.

Parámetros específicos pagados por el Mercado Pago

Servicio de creación de pagos HTML

A continuación se muestran los parámetros de solicitud específicos del Mercado Pago para servicio de creación de pagos HTML:

Parámetro	Descripción	Tamaño	Obligatorio
additional_data	Datos de transacciones adicionales.
application_fee	Importe de la comisión de Mercado Pago en centavos	< 12 N	NO
binary_mode	Modo binario de aprobación. Cuando se establece en true, el pago solo puede ser aprobado o denegado (NO está pendiente).	< 5 AN	NO
discount_campaign_id	Identificador de campaña de descuento	< 1024 AN	NO
discount_amount	Monto del cupón de descuento en centavos	< 12 N	NO
acquirer_expiry_date	Data de expiração do pagamento no formato AAAA-MM-DDTHH:MM:SS	= 19 AN	NO
acquirer_expiry_date_from	Fecha a partir de la cual estará activo el inicio del pago en el formato AAAA-MM-DDTHH:MM:SS	= 19 AN	NO
acquirer_expiry_date_to	Fecha de vencimiento de inicio de pago en el formato AAAA-MM-DDTHH:MM:SS	= 19 AN	NO
acquirer_expires	Booleano que indica si la iniciación del pago vence.	< 5 AN	NO
description	Motivo del pago o título del artículo	< 1024 AN	NO
extra_info	Informaciones adicionales.	< 1024 AN	NO
max_installments	Número máximo de cuotas.	< 2 N	NO
additional_data .items[]	Datos del carrito de compras. Es obligatorio enviar al menos un artículo y la suma de los precios del carrito debe ser igual al monto total de la transacción. (campo amount, en raiz de JSON).
id	ID de producto.	< 1024 AN	NO
title	Nombre del árticulo.	< 1024 AN	NO
description	Descripción del Artículo.	< 1024 AN	NO
picture_url	URL de la imagen del artículo.	< 1024 AN	NO
category_id	Categoría de artículo: art, baby, coupon, donation, computing, camera, video_game, television, car_eletronic, automotive, entertainment, fashion, game, home, musical, phone, service, learning, ticket, travel, virtual_good ou other	< 1024 AN	NO
quantity	Cantidad de objetos.	< 7 N	SIM
unit_price	Precio unitario del artículo en centavos.	< 12 N	SIM
additional_data .payer	Datos del comprador.
name	Nombre del comprador.	< 1024 AN	NO
surname	Apellido del comprador.	< 1024 AN	NO
email	Correo electrónico del comprador.	< 1024 AN	NO
creation_date	Fecha de creación de la cuenta en formato DD/MM/AAAA	= 10 AN	NO
identification_type	Tipo de identificación del comprador.	< 1024 AN	NO
identification_number	Número de identificación del comprador.	< 1024 AN	NO
type	Tipo de identificación de pagador asociado: guest, customer ou registered	< 10 AN	NO
additional_data .payer .phones[]	Teléfono del comprador.
ddd	Código de área del teléfono.	< 1024 AN	NO
number	Número de teléfono del comprador.	< 1024 AN	NO
additional_data .payer .address	Dirección del comprador.
street_name	Dirección del comprador.	< 1024 AN	NO
street_number	Número de dirección del comprador.	< 1024 AN	NO
zip_code	CEP del comprador.	< 1024 AN	NO
additional_data .shipment	Dirección de entrega.
mode	Modo de envio: custom = Customizado me2 = Mercado Envios not_specified = NO especificado	< 1024 AN	NO
local_pickup	Preferencia para eliminar paquetes en la agencia. (booleano). Apenas para mode = me2.	< 5 AN	NO
dimensions	Tamaño del paquete en cm x cm x cm, gr. Apenas para mode = me2.	< 1024 AN	NO
default_shipping_method	Elija un método de envío predeterminado al finalizar la compra. Apenas para mode = me2.	< 1024 AN	NO
cost	Costo de envío en centavos. Apenas para mode = custom.	< 12 N	NO
free_shipment	Preferencia de envío gratis (booleano). Apenas para mode = custom.	< 5 AN	NO
additional_data .shipment .free_methods[]	Ofrezca un método de envío gratuito. Apenas para mode = me2.
id	Identificador del método de envío	< 1024 AN	NO
additional_data .shipment .address	Dirección de entrega.
zip_code	Código postal de la dirección de entrega.	< 1024 AN	NO
street_number	número de dirección de envío.	< 1024 AN	NO
street_name	Nombre de la calle de entrega.	< 1024 AN	NO
floor	Número de piso de entrega.	< 1024 AN	NO
apartment	Número de apartamento de entrega.	< 1024 AN	NO
city	ciudad de entrega.	< 1024 AN	NO
state	Estado de entrega.	< 1024 AN	NO
additional_data .payment_method .excluded_payment_methods[]	Métodos de pago que se excluirán del flujo de pago Mercado Pago.
id	ID del método de pago que se eliminará: debelo = Elo Debito debmaster = Mastercard Débito visa = Visa master = Mastercard hipercard = Hipercard amex = American Express elo = Elo debvisa = Visa Débito pec = Pagamento na lotérica sem boleto bolbradesco = Boleto	< 1024 AN	NO
additional_data .payment_method .excluded_payment_types[]	Tipos de pago que se excluirán del flujo de pagos Mercado Pago.
id	ID del tipo de pago que se eliminará: debit_card, credit_card ou ticket.	< 1024 AN	NO
additional_data .payment_method .ad_tracks[]	Tracks que serão executados durante a interação do usuário no fluxo de Pagamento.
type	Tipo da track: google_ad: Configure una etiqueta de seguimiento de conversiones de Google Ads en GTM. Valores requeridos: conversion_id e conversion_label. facebook_ad: Le permite configurar un píxel de Facebook. Valores requeridos: pixel_id.	< 1024 AN	NO
conversion_id	Conversion ID da track.	< 1024 AN	NO
conversion_label	Conversion Label da track.	< 1024 AN	NO
pixel_id	Pixel ID da track.	< 1024 AN	NO

Ejemplo de JSON:

{

"merchant_id": "LOJAMERCADOPAGO",

"merchant_usn": "123456",

"amount": "100",

"soft_descriptor": "softDescriptor",

"additional_data": {

"extra_info": "extraInfo",

"items": [

{

"title": "Camiseta",

"quantity": "1",

"unit_price": "100",

"picture_url": "https://abc.def/item/552292339/zoom/10.jpg",

"category_id": "fashion",

"description": "Camiseta Preta",

"id": "id"

}

],

"payer": {

"name": "Jonas",

"surname": "Melo",

"email": "a@b.com",

"date_created": "11/02/2015",

"address": {

"zip_code": "12345678",

"street_number": "751",

"street_name": "Rua Major Vitor"

},

"phones": [

{

"number": "912341234",

"ddd": "11"

}

],

"identification_type": "CPF",

"identification_number": "86670573049"

},

"payment_method": {

"excluded_payment_methods": [

{

"id": "debelo"

}

],

"excluded_payment_types": [

{

"id": "debit_card"

}

]

},

"shipment": {

"mode": "not_specified",

"local_pickup": "true",

"dimensions": "23x23x23, 23g",

"default_shipping_method": "45",

"cost": "2",

"free_shipment": "true",

"address": {

"zip_code": "87654321",

"street_number": "920",

"street_name": "Rua General Henrique",

"floor": "1",

"apartment": "23",

"city": "São Mateus",

"state": "AM"

},

"free_methods": [

{

"id": "621"

}

]

},

"max_installments": "12",

"application_fee": "1",

"acquirer_expiry_date": "2021-06-02T11:05:27",

"acquirer_expiry_date_from": "2021-06-01T11:05:27",

"acquirer_expiry_date_to": "2021-06-03T11:05:27",

"acquirer_expires": "false",

"ad_tracks": [

{

"conversion_id": "conversionId",

"type": "google_ad",

"conversion_label": "conversionLabel"

}

]

}

}