/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 do pagante.
id
String
Identificação do pagante associado.
email
String
E-mail do pagante.
type
String
Tipo de identificação do pagante associado (exigido se o pagante é um cliente).
customer
O pagante é um cliente e pertence a um coletor.
registered
A conta corresponde a um usuário cadastrado do Mercado Pago.
identification
Object
Identificação pessoal.
type
String
Tipo de identificação.
number
String
Número de identificação.
address
Object
Endereço.
zip_code
String
CEP.
street_name
String
Rua.
street_number
Integer
Número.
phone
Object
Telefone do pagante associado.
area_code
String
DDD
number
String
Número de telefone
extension
String
Ramal do número de telefone.
first_name
String
Nome do pagante associado.
last_name
String
Sobrenome do pagante associado.
payments
Array(Object)
Lista de pagamentos feitos pelo comprador.
id
Number
Identificador do pagamento.
status
String
Status do pagamento.
status_detail
String
Detalhes do status do pagamento.
payment_type_id
String
Tipo de meio de pagamento selecionado.
payment_method_id
String
Meio de pagamento selecionado para pagar.
token
String
Identificador de token.
transaction_amount
Float
Custo do produto.
installments
Integer
Número de parcelas selecionado.
processing_mode
String
Modo de processar os pagamentos (por padrão é aggregator).
aggregator
en
es
pt
gateway
issuer_id
String
Identificador do emissor do meio de pagamento.
description
String
Razão do pagamento.
capture
Boolean
Determina se o pagamento deve ser capturado(true, default value) ou somente reservado (false).
external_reference
String
Identificador fornecido pelo vendedor no seu sistema.
statement_descriptor
String
Como o pagamento aparecerá na fatura do cartão.
date_of_expiration
String
Data de vencimento para o caso de forma de pagamento “ticket”.
transaction_details
Object
Agrupa os detalhes da transação.
external_resource_url
String
Identifica o recurso no processador de pagamento.
disbursements
Array(Object)
Lista de pagamentos que correspondem a cada Vendedor.
id
Number
Identificador do pagamento.
amount
Float
Valor do pagamento.
external_reference
String
Identificador fornecido pelo vendedor no seu sistema.
collector_id
Integer
Identificador do vendedor.
application_fee
Float
Tarifa recolhida pelo Marketplace.
money_release_days
Float
Número de dias (a partir da data de aprovação do pagamento) em que o pagamento será liberado para o vendedor.
binary_mode
Boolean
Quando o pagamento está ativado, só pode ser aprovado ou rejeitado. Caso contrário, o pagamento pode ficar pendente.
metadata
Object
JSON válido que pode ser adicionado ao pagamento para salvar atributos adicionais.
application_id
Object
ID do Marketplace.
additional_info
Object
Informações que podem melhorar a análise de prevenção de fraude e a taxa de conversão. Tente nos enviar o máximo de informações possível.
ip_address
String
IP de onde vem o request (somente transferência bancária)
items
Array(Object)
Lista de itens a pagar.
id
String
Código do item.
title
String
Nome do item.
description
String
Descrição do item.
picture_url
String
URL da imagem.
category_id
String
Categoria do item.
quantity
Integer
Número de itens.
unit_price
Float
Preço unitário.
payer
Object
Informações do comprador.
first_name
String
Nome do comprador.
last_name
String
Sobrenome do comprador.
phone
Object
Telefone do comprador.
area_code
String
DDD.
number
String
Número telefônico.
registration_date
Date
Data de cadastro do comprador no seu site.
shipments
Object
Informações de envio.
receiver_address
Object
Endereço do comprador.
zip_code
String
CEP.
street_name
String
Rua.
street_number
Integer
Número.
floor
String
Andar.
apartment
String
Apartamento.
Error Codes
CodeDescription
400 BAD_REQUEST
400004
Aplicação inválida.
400005
A aplicação é obrigatória.
400006
Data de liberação inválida para o Disbursement.
400007
Data de liberação inválida para o Disbursement.
400013
E-mail inválido.
400014
Número de pagamentos inválidos.
400015
ID do Payer é obrigatória para pagamentos com dinheiro em conta.
400016
Tipo de pagamento inválido.
400017
O valor da transação é obrigatório.
400018
Valor inválido.
400019
A forma de pagamento é obrigatória.
400020
O tipo de pagamento é obrigatório.
400021
O formato do valor é inválido.
400022
Modo de processamento inválido.
400023
O tipo de payer é obrigatório.
400024
O nome do payer é obrigatório.
400025
O sobrenome do payer é obrigatório.
400026
O tipo de identificação do payer é obrigatório.
400027
O número de identificação do payer é obrigatório.
400028
A data de vencimento é obrigatória.
400029
O token do pagamento é obrigatório.
400030
As parcelas são obrigatórias.
400031
O valor dos desembolsos é obrigatório.
400032
O ID do collector é obrigatório.
400033
Tarifa recolhida pelo Marketplace.
400034
Valor do desembolso inválido.
400035
O campo money_release_date é inválido.
400036
O Marketplace não tem permissões de acesso sobre o payer.
400037
O collector não foi encontrado.
400039
Request inválido.
400040
Status inválido.
400041
Data de início inválida.
400042
Data de fim inválida.
400043
E-mail inválido.
400044
ID do payer inválido.
400045
ID do collector inválido.
400046
O campo external_reference é inválido.
400047
Alguns parâmetros da busca são inválidos.
400048
ID inválido.
400049
Data da última modificação inválida.
400051
O campo money_release_date é obrigatório.
400052
O campo processing_mode é obrigatório.
400053
Conteúdo inválido.
400054
O Marketplace não possui permissões de acesso sobre o collector.
400055
O campo external_reference é obrigatório.
400056
O campo money_release_days é inválido.
400057
Os campos collector_id e external_reference estão duplicados.
400058
Chave de idempotência inválida.
401 UNAUTHORIZED
401000
Access token inválido.
401002
Access token inválido.
401003
Device token inválido.
404 NOT_FOUND
404001
O Disbursement não foi encontrado.
404002
O Advanced Payment não foi encontrado.
404003
O Payer não foi encontrado.
406 NOT_ACCEPTABLE
406001
Erro na API de payments.