/v1/advanced_payments/:id
BASE URI https://api.mercadopago.com/v1/advanced_payments/{id}
HTTP Request
curl
curl -X GET \
'https://api.mercadopago.com/v1/advanced_payments/:ID' \
-H 'Authorization: Bearer MKT_ACCESS_TOKEN'
Request Params
ParameterTypeDescription
id
Long
Identificador de Advanced Payment.
HTTP Response
json
{
"id": 111111111,
"status": "approved",
"payments": [
{
"id": 222222222,
"status": "approved",
"status_detail": "accredited",
"payment_type_id": "credit_card",
"payment_method_id": "visa",
"token": "98f6a9s7dfyihfasfdhasdjfhñasdfh",
"transaction_amount": 100,
"installments": 1,
"processing_mode": "aggregator",
"description": "Payment description",
"capture": true,
"external_reference": "ext_ref_payment",
"statement_descriptor": "MKT-STATEMENT-DESCRIPTION"
}
],
"disbursements": [
{
"id": 33333333,
"amount": 40,
"external_reference": "ext_ref_disb_1",
"collector_id": 31313,
"application_fee": 5,
"money_release_days": 10,
"additional_info": {
"items": [
{
"id": "item-ID-1234",
"title": "Title of what you are paying for",
"picture_url": "https://www.mercadopago.com/logomp3.gif",
"description": "Item description",
"category_id": "art",
"quantity": 1,
"unit_price": 100
}
],
"shipments": {
"receiver_address": {
"zip_code": "5700",
"street_name": "Street",
"street_number": 123,
"floor": 4,
"apartment": "C"
}
}
}
},
{
"id": 44444444,
"amount": 60,
"external_reference": "ext_ref_disb_2",
"collector_id": 41414,
"application_fee": 10,
"money_release_days": 30,
"additional_info": {
"items": [
{
"id": "item-ID-4512",
"title": "Title of what you are paying for",
"picture_url": "https://www.mercadopago.com/logomp3.gif",
"description": "Item description",
"category_id": "art",
"quantity": 1,
"unit_price": 100
}
],
"shipments": {
"receiver_address": {
"zip_code": "5700",
"street_name": "Street",
"street_number": 123,
"floor": 4,
"apartment": "C"
}
}
}
}
],
"payer": {
"email": "test@user.com",
"first_name": "Test",
"last_name": "Test",
"address": {
"zip_code": "1111",
"street_name": "Calle",
"street_numer": "120"
},
"identification": {
"type": "DNI",
"number": "88999000"
}
},
"external_reference": "ext_ref_adv_paym",
"description": "Advanced payment description",
"binary_mode": false,
"date_created": "2018-06-27T09:34:20.518-04:00",
"date_last_updated": "2018-06-27T09:34:20.518-04:00",
"metadata": {},
"additional_info": {
"items": [
{
"id": "item-ID-7356",
"title": "Title of what you are paying for",
"picture_url": "https://www.mercadopago.com/logomp3.gif",
"description": "Item description",
"category_id": "art",
"quantity": 1,
"unit_price": 100
}
],
"shipments": {
"receiver_address": {
"zip_code": "5700",
"street_name": "Street",
"street_number": 123,
"floor": 4,
"apartment": "C"
}
}
}
}
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.