Payment
Attributes
AttributeTypeDescription
id
Long
Identificador de pagamento.
date_created
Date(ISO_8601)
Data de criação do pagamento.
date_approved
Date(ISO_8601)
Data de aprovação do pagamento.
date_last_updated
Date(ISO_8601)
Data da última modificação.
money_release_date
Date(ISO_8601)
Data de liberação do pagamento.
collector_id
Integer
Identificação do vendedor.
operation_type
String
Tipo de pagamento.
regular_payment
Typification by default of a purchase being paid using Mercado Pago.
money_transfer
Funds transfer between two users.
recurring_payment
Automatic recurring payment due to an active user subscription.
account_fund
Money income in the user's account.
payment_addition
Addition of money to an existing payment, done in Mercado Pago's site.
cellphone_recharge
Recharge of a user's cellphone account.
pos_payment
Payment done through a Point Of Sale.
payer
Object
Id do pagador.
entity_type
String
Tipo de entidade do pagador (apenas para transferências bancárias).
individual
Payer is individual.
association
Payer is an association.
type
String
Tipo de identificação do pagador associado (se necessário o pagador é um cliente).
customer
Payer is a Customer and belongs to the collector.
registered
The account corresponds to a Mercado Pago registered user.
guest
The payer doesn't have an account.
id
String
Identificação do pagador associado.
email
String
E-mail. (Obrigatório)
identification
Object
Identificação pessoal.
type
String
Tipo de identificação.
number
String
Número de identificação.
phone
Object
Telefone do pagador associado.
area_code
String
Código de área.
number
String
Número de telefone.
extension
String
Extensão do número de telefone.
first_name
String
Nome do pagador associado.
last_name
String
Nome do pagador associado.
binary_mode
Boolean
Quando estiver ativado, o pagamento só pode ser aprovado ou rejeitado. De não estar ativado, para além deste estado, o pagamento pode ser pendente (in_process).
live_mode
Boolean
Indica se o pagamento é processado em ambiente de sandbox ou produção.
order
Object
Identificador de ordem.
type
String
Tipo de ordem.
mercadolibre
The order is from Mercado Libre.
mercadopago
It is a Mercado Pago merchant_order.
id
Long
Identificação da ordem de compra associada.
external_reference
String
Identificação fornecida pelo vendedor em seu sistema.
description
String
Razão de pagamento ou título do item.
metadata
Object
JSON válido que pode ser adicionado ao pagamento para salvar atributos adicionais do comprador.
currency_id
String(3)
Identificador da moeda utilizada no pagamento.
ARS
Argentine peso.
BRL
Brazilian real.
CLP
Chilean peso.
MXN
Mexican peso.
COP
Colombian peso.
PEN
Peruvian sol.
UYU
Uruguayan peso.
transaction_amount
Float
Custo do produto. (Obrigatório)
transaction_amount_refunded
Float
Valor total reembolsado este pagamento.
coupon_amount
Float
Valor do cupom de desconto.
date_of_expiration
Date(ISO_8601)
Data de expiração do pagamento.
campaign_id
Integer
Identificador da campanha de desconto.
coupon_code
String
Campanha de desconto com um código específico.
transaction_details
Object
Agrupa os detalhes da transação.
financial_institution
String
Identificação da instituição financeira externa (por ex: company id para atm)
net_received_amount
Float
Valor recebido pelo vendedor.
total_paid_amount
Float
Valor pago pelo comprador (inclui comissões).
installment_amount
Float
Valor total da quota.
overpaid_amount
Float
Valor pago por outras pessoas (apenas para tickets).
external_resource_url
String
Identifica o recurso no processador de pagamento.
payment_method_reference_id
String
Para pagamentos com cartão de crédito é USN. Para meios de pagamento offline é a referência para lhe dar o caixa ou introduzir no ATM.
fee_details
Array(Object)
Lista de comissões.
type
String
Detalhe de comissão.
mercadopago_fee
Cost for using Mercado Pago.
coupon_fee
Discount given by a coupon.
financing_fee
Cost of financing.
shipping_fee
Shipping cost.
application_fee
Marketplace comision for the service.
discount_fee
Discount given by the seller through cost absorption.
fee_payer
String
Quem absorve o custo da comissão.
collector
The seller absorbs the cost.
payer
The buyer absorbs the cost.
amount
Float
Valor da comissão.
differential_pricing_id
Integer
Id do esquema de absorção do custo financeiro.
application_fee
Float
Comissão coletadas pelo mercado ou pelo Mercado Pago.
status
String
Estado do pagamento.
pending
The user has not yet completed the payment process.
approved
The payment has been approved and accredited.
authorized
The payment has been authorized but not captured yet.
in_process
Payment is being reviewed.
in_mediation
Users have initiated a dispute.
rejected
Payment was rejected. The user may retry payment.
cancelled
Payment was cancelled by one of the parties or because time for payment has expired
refunded
Payment was refunded to the user.
charged_back
Was made a chargeback in the buyer’s credit card.
status_detail
String
Fornece informação detalhada do estado atual, ou o motivo de rejeição.
capture
Boolean
Determina se o pagamento deve ser capturado(true, default value), ou apenas reservado(false).
captured
Boolean
Determina se a captura de a operação foi realizada (somente para cartões de crédito).
call_for_authorize_id
String
Identificador que deve ser fornecida ao banco emissor para autorizar o pagamento.
payment_method_id
String
Meio de pagamento escolhido para fazer o pagamento. (Obrigatório)
issuer_id
String
Id do emitente do meio de pagamento.
payment_type_id
String
Tipo do meio de pagamento escolhido.
account_money
Money in the Mercado Pago account.
ticket
Printed ticket.
bank_transfer
Wire transfer.
atm
Payment by ATM.
credit_card
Payment by credit card.
debit_card
Payment by debit card.
prepaid_card
Payment by prepaid card.
token
String
Identificador de token card. (Obrigatório para cartão de crédito)
card
Object
Os detalhes do cartão utilizado.
id
Number
Identificação da placa.
last_four_digits
String
Últimos quatro dígitos do número do cartão.
first_six_digits
String
Os primeiros seis dígitos do número do cartão.
expiration_year
Integer
Ano de validade do cartão.
expiration_month
Integer
Mês de validade do cartão.
date_created
Date(ISO_8601)
Data de criação do cartão.
date_last_updated
Date(ISO_8601)
Data de última atualização de informações de cartão.
cardholder
Object
Informações sobre o dono do cartão.
name
String
Nome do proprietário tarjata.
identification
Object
Identificação do proprietário do cartão.
number
String
Número do documento.
type
String
Tipo de documento.
statement_descriptor
String
Como aparecerá o pagamento no extrato do cartão (ex: o MERCADOPAGO).
installments
Integer
Quantidade selecionada de cotas. (Obrigatório)
notification_url
String
URL para qual Mercado Pago enviará notificações associadas a mudanças no status do pagamento.
callback_url
String
URL para a qual o Mercado Pago faz o redirecionamento final (apenas para transferência bancária).
refunds
Array(Object)
Lista de reembolsos que foram feitas a este pagamento.
id
Number
Identificador de reembolso.
payment_id
Number
Id do pagamento, o qual lhe fez um reembolso.
amount
Float
Valor reembolsado.
metadata
Object
JSON válido que pode ser adicionado ao pagamento para salvar atributos adicionais do comprador.
source
Object
Quem fez o reembolso.
id
String
Id do usuário que fez o reembolso.
name
String
Nome do usuário que fez o reembolso.
type
String
Tipo de usuário que fez o reembolso.
collector
The collector issued the refund.
operator
The refund was made by an account's operator.
admin
The refund was made by a Mercado Pago administrator.
bpp
The refund was made by the Mercado Pago's Buyer Protection Program
date_created
Date(ISO_8601)
Data do reembolso.
unique_sequence_number
String
Identificador de reembolso concedido pelo processador de cartão.
additional_info
Object
Informações que podem melhorar a análise de prevenção de fraude e a taxa de conversão. Trata de enviar-nos toda a informação possível.
ip_address
String
IP do qual provém o request (apenas para transferência bancária).
items
Array(Object)
Lista de itens a pagar.
id
String
Código de anúncio.
title
String
Nome do item.
description
String
Descrição do artigo.
picture_url
String
URL da imagem.
category_id
String
Categoria do item.
quantity
Integer
Quantidade de itens.
unit_price
Float
Preço unitário.
payer
Object
Informação do comprador.
first_name
String
Nome do comprador.
last_name
String
Apelido do comprador.
phone
Object
Telefone do comprador.
area_code
String
Código de área.
number
String
Número de telefone.
address
Object
Endereço.
zip_code
String
Código postal.
street_name
String
Rua.
street_number
Integer
O Número.
registration_date
Date
Data de cadastro do comprador em seu site.
shipments
Object
Informações de envio.
receiver_address
Object
Endereço do comprador.
zip_code
String
Zip code.
state_name
String
Província.
city_name
String
Cidade.
street_name
String
Rua.
street_number
Integer
O Número.
floor
String
Apartamento.
apartment
String
Departamento.
barcode
Object
Informação de código de barra.
type
String
Tipo de encoding.
UCC/EAN 128
Encodes data using the Code 128 symbology.
Code128C
High-density alphanumeric code.
Code39
Media density code.
content
String
Código de barras gerado.
width
Integer
Largura do código de barras.
height
Integer
Altura do código de barras.