/v1/advanced_payments
BASE URI https://api.mercadopago.com/v1/advanced_payments
HTTP Request
curl
curl -X POST \
'https://api.mercadopago.com/advanced_payments' \
-H 'Authorization: Bearer MKT_ACCESS_TOKEN'
Request Params
ParameterTypeDescription
payer
Object
Identificador del pagador.
id
String
Identificación del pagador asociado.
email
String
E-mail del pagador.
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.
identification
Object
Identificación personal.
type
String
Tipo de identificación.
number
String
Número de identificación.
address
Object
Dirección.
zip_code
String
Código postal.
street_name
String
Calle.
street_number
Integer
Número.
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.
payments
Array(Object)
Lista de pagos realizados por el comprador.
id
Number
Identificador del pago.
status
String
Estado del pago.
status_detail
String
Detalle del estado del pago.
payment_type_id
String
Tipo del medio de pago elegido.
payment_method_id
String
Medio de pago elegido para hacer el pago.
token
String
Identificador de card token.
transaction_amount
Float
Costo del producto.
installments
Integer
Cantidad seleccionada de cuotas.
processing_mode
String
Modo de procesar los pagos (por defecto es aggregator).
aggregator
en
es
es
es
pt
es
gateway
issuer_id
String
Identificador del emisor del medio de pago.
description
String
Razón de pago.
capture
Boolean
Determina si el pago debe ser capturado(true, default value) o sólo reservado(false).
external_reference
String
Identificador provisto por el vendedor en su sistema.
statement_descriptor
String
Cómo aparecerá el pago en el resumen de tarjeta.
date_of_expiration
String
Fecha de expiración para el caso de método de pago "ticket".
transaction_details
Object
Agrupa los detalles de la transacción.
external_resource_url
String
Identifica el recurso en el procesador de pago.
disbursements
Array(Object)
Lista de pagos que corresponden a cada Vendedor.
id
Number
Identificador del pago.
amount
Float
Monto del pago.
external_reference
String
Identificador provisto por el vendedor en su sistema.
collector_id
Integer
Identificador de vendedor.
application_fee
Float
Comisión recolectada por el Marketplace.
money_release_days
Float
Cantidad de días (a partir de la fecha de aprobación del pago) en que se va a liberar el pago del Vendedor.
binary_mode
Boolean
Cuando está activado, el pago sólo puede resultar aprobado o rechazado. De lo contrario, el pago puede resultar pendiente.
metadata
Object
JSON válido que puede agregarse al pago para guardar atributos adicionales.
application_id
Object
ID del Marketplace.
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 informació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.
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
Código postal.
street_name
String
Calle.
street_number
Integer
Número.
floor
String
Piso.
apartment
String
Departamento.
Error Codes
CodeDescription
400 BAD_REQUEST
400004
Aplicación inválida.
400005
La aplicación es requerida.
400006
Fecha de liberación inválida para el Disbursement.
400007
Fecha de liberación inválida para el Disbursement.
400013
Email inválido.
400014
Cantidad de pagos inválidos.
400015
ID del Payer es requerido para pagos con dinero en cuenta.
400016
Tipo de pago inválido.
400017
El monto de la transacción es requerido.
400018
Monto inválido.
400019
El método de pago es requerido.
400020
El tipo de pago es requerido.
400021
El formato del monto es inválido.
400022
Modo de procesamiento inválido.
400023
El tipo del payer es requerido.
400024
El nombre del payer es requerido.
400025
El apellido del payer es requerido.
400026
El tipo de identificación del payer es requerida.
400027
El número de identificación del payer es requerido.
400028
La fecha de expiración es requerida.
400029
El token del pago es requerido.
400030
Las cuotas son requeridas.
400031
El monto de los desembolsos es requerido.
400032
El ID del collector es requerido.
400033
Comisión del marketplace inválida.
400034
Monto del desembolso inválido.
400035
El campo money_release_date inválido.
400036
El Marketplace no tiene permisos sobre el payer.
400037
No se encontró el collector.
400039
Request inválido.
400040
Estado inválido.
400041
Fecha de inicio inválida.
400042
Fecha de fin inválida.
400043
Email inválido.
400044
Id del payer inválido.
400045
Id del collector inválido.
400046
El campo external_reference es inválido.
400047
Algunos parámetros de la búsqueda son inválidos.
400048
Id inválido.
400049
Fecha de última modificación inválida.
400051
El campo money_release_date es requerido.
400052
El campo processing_mode es requerido.
400053
Contenido inválido.
400054
El Marketplace no tiene permisos sobre el collector.
400055
El campo external_reference es requerido.
400056
El campo money_release_days es inválido.
400057
El campo collector_id y external_reference están duplicados.
400058
Clave de idempotencia inválida.
401 UNAUTHORIZED
401000
Access token inválido.
401002
Access token inválido.
401003
Device token inválido.
404 NOT_FOUND
404001
No se encontró el Disbursement.
404002
No se encontró el Advanced Payment.
404003
No se encontró el Payer.
406 NOT_ACCEPTABLE
406001
Error en api de payments.