Payment
Attributes
AttributeTypeDescription
id
Long
Identificador de pago.
date_created
Date(ISO_8601)
Fecha de creación del pago.
date_approved
Date(ISO_8601)
Fecha de aprobación del pago.
date_last_updated
Date(ISO_8601)
Fecha de la última modificación.
money_release_date
Date(ISO_8601)
Fecha de liberación del pago.
collector_id
Integer
Identificador de vendedor.
operation_type
String
Tipo de pago.
regular_payment
Tipificación por defecto de una compra pagada con Mercado Pago.
money_transfer
Transferencia de fondos entre usuarios.
recurring_payment
Pago recurrente automático por una suscripción de un usuario activo.
account_fund
Ingreso de fondos en la cuenta del usuario.
payment_addition
Agregado de dinero a un pago existente realizado en el sitio de Mercado Pago.
cellphone_recharge
Recarga de la cuenta telefónica de un usuario.
pos_payment
Pago realizado en un dispositivo POS.
payer
Object
Identificador del pagador.
entity_type
String
Tipo de entidad del pagador (sólo para transferencias bancarias).
individual
El pagador es único.
association
El pagador es una asociación.
type
String
Tipo de identificación del pagador asociado (requerido si el pagador es un cliente).
customer
El pagador es un cliente y pertenece al collector.
registered
La cuenta corresponde a un usuario registrado de Mercado Pago.
guest
El pagador no tiene una cuenta.
id
String
Identificación del pagador asociado.
email
String
Email. (Obligatorio)
identification
Object
Identificación personal.
type
String
Tipo de identificación.
number
String
Número de identificación.
phone
Object
Teléfono del pagador asociado.
area_code
String
Código de área.
number
String
Número de teléfono.
extension
String
Extensión del número de teléfono.
first_name
String
Nombre del pagador asociado.
last_name
String
Apellido del pagador asociado.
binary_mode
Boolean
Cuando está activado el pago solo puede resultar aprobado o rechazado. De no estar activado, además de este estado el pago puede resultar pendiente (in_process).
live_mode
Boolean
Indica si el pago se procesará en entorno de sandbox o producción.
order
Object
Identificador de orden.
type
String
Tipo de orden.
mercadolibre
La orden es de Mercado Libre.
mercadopago
Es una merchant_order de Mercado Pago.
id
Long
Identificador de la orden de compra asociada.
external_reference
String
Identificador provisto por el vendedor en su sistema.
description
String
Razón de pago o título de ítem.
metadata
Object
JSON válido que puede agregarse al pago para guardar atributos adicionales del comprador.
currency_id
String(3)
Identificador de la moneda utilizada en el pago.
ARS
Peso argentino.
BRL
Real brasilero.
CLP
Peso chileno.
MXN
Peso mexicano.
COP
Peso colombiano.
PEN
Sol peruano.
UYU
Peso uruguayo.
transaction_amount
Float
Costo del producto. (Obligatorio)
transaction_amount_refunded
Float
Monto total reembolsado en este pago.
coupon_amount
Float
Monto del cupón de descuento.
date_of_expiration
Date(ISO_8601)
Fecha de expiración del pago.
campaign_id
Integer
Identificador de la campaña de descuento.
coupon_code
String
Campaña de descuento con un código específico.
transaction_details
Object
Agrupa los detalles de la transacción.
financial_institution
String
Identificador de la institución financiera externa (ej.: company id para atm)
net_received_amount
Float
Monto recibido por el vendedor.
total_paid_amount
Float
Monto pagado por el comprador (incluye comisiones).
installment_amount
Float
Monto total de cuota.
overpaid_amount
Float
Monto pagado por demás (sólo para tickets).
external_resource_url
String
Identifica el recurso en el procesador de pago.
payment_method_reference_id
String
Para pagos con tarjeta de crédito es USN. Para medios de pago offline es la referencia para darle al cajero o ingresarla en el ATM.
fee_details
Array(Object)
Lista de comisiones.
type
String
Detalle de comisión.
mercadopago_fee
Costo de usar Mercado Pago.
coupon_fee
Descuento otorgado por un cupón.
financing_fee
Costo de financiación.
shipping_fee
Costo de envío.
application_fee
Comisión de servicio del Marketplace.
discount_fee
Descuento otorgado por el vendedor absorviendo el costo.
fee_payer
String
Indica quién absorve el costo de la comisión.
collector
El vendedor absorve el costo.
payer
El comprador absorve el costo.
amount
Float
Monto de la comisión.
differential_pricing_id
Integer
Identificador del esquema de absorción del costo financiero.
application_fee
Float
Comisión recolectada por el marketplace o por Mercado Pago.
status
String
Estado del pago.
pending
El usuario no completo el proceso de pago todavía.
approved
El pago fue aprobado y acreditado.
authorized
El pago fue autorizado pero no capturado todavía.
in_process
El pago está en revisión.
in_mediation
El usuario inició una disputa.
rejected
El pago fue rechazado. El usuario podría reintentar el pago.
cancelled
El pago fue cancelado por una de las partes o el pago expiró.
refunded
El pago fue devuelto al usuario.
charged_back
Se ha realizado un contracargo en la tarjeta de crédito del comprador.
status_detail
String
Brinda información detallada del estado actual o el motivo de rechazo.
capture
Boolean
Determina si el pago debe ser capturado(true, default value) o solo reservado(false).
captured
Boolean
Determina si la captura de la operación fue realizada (sólo para tarjetas de crédito).
call_for_authorize_id
String
Identificador que debe ser provisto al banco emisor para autorizar el pago.
payment_method_id
String
Medio de pago elegido para hacer el pago. (Obligatorio)
issuer_id
String
Identificador del emisor del medio de pago.
payment_type_id
String
Tipo del medio de pago elegido.
account_money
Dinero en la cuenta de Mercado Pago.
ticket
Ticket impreso.
bank_transfer
Transferencia bancaria.
atm
Pago en ATM.
credit_card
Pago con tarjeta de crédito.
debit_card
Pago con tarjeta de débito.
prepaid_card
Pago con tarjeta prepaga.
token
String
Identificador de card token. (Obligatorio para tarjeta de crédito)
card
Object
Detalles de la tarjeta utilizada.
id
Number
Identificador de la tarjeta.
last_four_digits
String
Últimos cuatro dígitos del número de la tarjeta.
first_six_digits
String
Primeros seis dígitos del número de la tarjeta.
expiration_year
Integer
Año de expiración de la tarjeta.
expiration_month
Integer
Mes de expiración de la tarjeta.
date_created
Date(ISO_8601)
Fecha de creación de la tarjeta.
date_last_updated
Date(ISO_8601)
Fecha de última actualización de la información de la tarjeta.
cardholder
Object
Información sobre el dueño de la tarjeta.
name
String
Nombre del propietario de la tarjata.
identification
Object
Identificación del propietario de la tarjeta.
number
String
Número de documento.
type
String
Tipo de documento.
statement_descriptor
String
Cómo aparecerá el pago en el resumen de tarjeta (ej.: MERCADOPAGO).
installments
Integer
Cantidad seleccionada de cuotas. (Obligatorio)
notification_url
String
URL a la cual Mercado Pago enviará notificaciones asociadas a cambios en el estado del pago.
callback_url
String
URL a la cual Mercado Pago hace la redirección final (sólo para transferencia bancaria).
refunds
Array(Object)
Lista de reembolsos que fueron realizados a este pago.
id
Number
Identificador de reembolso.
payment_id
Number
Identificador del pago al cual se le hizo un reembolso.
amount
Float
Monto reembolsado.
metadata
Object
JSON válido que puede agregarse al pago para guardar atributos adicionales del comprador.
source
Object
Indica quién hizo el reembolso.
id
String
Identificador del usuario que hizo el reembolso.
name
String
Nombre del usuario que hizo el reembolso.
type
String
Tipo de usuario que hizo el reembolso.
collector
El vendedor hizo el reembolso.
operator
Un operador de cuenta hizo el reembolso.
admin
El reembolso fue realizado por un administrador de Mercado Pago.
bpp
El reembolso fue realizado por el programa de protección al comprador de Mercado Pago.
date_created
Date(ISO_8601)
Fecha del reembolso.
unique_sequence_number
String
Identificador de reembolso otorgado por el procesador de tarjeta.
additional_info
Object
Información que puede mejorar el análisis de prevención de fraude y la tasa de conversión. Trata de enviarnos toda la infomación posible.
ip_address
String
IP del cual proviene el request (sólo para transferencia bancaria).
items
Array(Object)
Lista de ítems a pagar.
id
String
Código de ítem.
title
String
Nombre de ítem.
description
String
Descripción de item.
picture_url
String
URL de imagen.
category_id
String
Categoría del ítem.
quantity
Integer
Cantidad de ítems.
unit_price
Float
Precio unitario.
payer
Object
Información del comprador.
first_name
String
Nombre del comprador.
last_name
String
Apellido del comprador.
phone
Object
Teléfono del comprador.
area_code
String
Código de área.
number
String
Número telefónico.
address
Object
Dirección.
zip_code
String
Código postal.
street_name
String
Calle.
street_number
Integer
Número.
registration_date
Date
Fecha de registración del comprador en tu sitio.
shipments
Object
Información de envío.
receiver_address
Object
Dirección del comprador.
zip_code
String
Zip code.
state_name
String
Provincia.
city_name
String
Ciudad.
street_name
String
Calle.
street_number
Integer
Número.
floor
String
Piso.
apartment
String
Departmento.
barcode
Object
Información de código de barra.
type
String
Tipo de encoding.
UCC/EAN 128
Codifica data utilizando la simbología 128.
Code128C
Código alfanumérico de alta densidad.
Code39
Código de densidad multimedia.
content
String
Código de barras generado.
width
Integer
Ancho del código de barras.
height
Integer
Altura del código de barras.