/v1/payments

BASE URI https://api.mercadopago.com/v1/payments

HTTP Request

curl

 curl -X POST \
  'https://api.mercadopago.com/v1/payments' \
  -H 'Authorization: Bearer ACCESS_TOKEN_ENV' \
  -d '{
	"token":"b3a7dbec3eb0d71798c4f19fec445795",
	"installments":1,
	"transaction_amount":58.80,
	"description":"Point Mini a maquininha que dá o dinheiro de suas vendas na hora",
	"payment_method_id":"visa",
	"payer":{
		"email":"test_user_123456@testuser.com",
		"identification": {
                	"number": "19119119100",
                	"type": "CPF"
            	}
	},
	"notification_url":"https://www.suaurl.com/notificacoes/",
	"sponsor_id":null,
	"binary_mode":false,
	"external_reference":"MP0001",
	"statement_descriptor":"MercadoPago",
	"additional_info":{
		"items":[
		{
			"id":"PR0001",
			"title":"Point Mini",
			"description": "Producto Point para cobros con tarjetas mediante bluetooth",
			"picture_url":"https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium@2x.png",
			"category_id": "electronics",
			"quantity":1,
			"unit_price":58.80
		}
		],
		"payer":{
			"first_name":"Nome",
			"last_name":"Sobrenome",
			"address":{
				"zip_code":"06233-200",
				"street_name":"Av das Nacoes Unidas",
				"street_number":3003
			},
			"registration_date":"2019-01-01T12:01:01.000-03:00",
			"phone":{
				"area_code":"011",
				"number":"987654321"
			}
		},
		"shipments":{
			"receiver_address":{
				"street_name":"Av das Nacoes Unidas",
				"street_number":3003,
				"zip_code":"06233200",
				"city_name": "Buzios",
				"state_name": "Rio de Janeiro"
			}
		}
  	}
}'
 

Request Params

ParameterTypeDescription
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).
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.
transaction_amount Float Custo do produto. (Obrigatório)
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.
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.
capture Boolean Determina se o pagamento deve ser capturado(true, default value), ou apenas reservado(false).
payment_method_id String Meio de pagamento escolhido para fazer o pagamento. (Obrigatório)
issuer_id String Id do emitente do meio de pagamento.
token String Identificador de token card. (Obrigatório para cartão de crédito)
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).
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.

HTTP Response

json

 {
    "id": 20359978,
    "date_created": "2019-07-10T10:47:58.000-04:00",
    "date_approved": "2019-07-10T10:47:58.000-04:00",
    "date_last_updated": "2019-07-10T10:47:58.000-04:00",
    "date_of_expiration": null,
    "money_release_date": "2019-07-24T10:47:58.000-04:00",
    "operation_type": "regular_payment",
    "issuer_id": "25",
    "payment_method_id": "visa",
    "payment_type_id": "credit_card",
    "status": "approved",
    "status_detail": "accredited",
    "currency_id": "[FAKER][CURRENCY][ACRONYM]",
    "description": "Point Mini a maquininha que dá o dinheiro de suas vendas na hora",
    "live_mode": false,
    "sponsor_id": null,
    "authorization_code": null,
    "money_release_schema": null,
    "taxes_amount": 0,
    "counter_currency": null,
    "shipping_amount": 0,
    "pos_id": null,
    "store_id": null,
    "collector_id": 448876418,
    "payer": {
        "first_name": "Test",
        "last_name": "Test",
        "email": "test_user_80507629@testuser.com",
        "identification": {
        	"number": "19119119100",
                "type": "CPF"
        }
        "phone": {
		"area_code": "011",
		"number": "987654321",
		"extension": ""
        },
        "type": "guest",
        "entity_type": null,
        "id": null
    },
    "metadata": {},
    "additional_info": {
    	"items": [
        {
		"id":"PR0001",
		"title":"Point Mini",
		"description": "Producto Point para cobros con tarjetas mediante bluetooth",
		"picture_url":"https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium@2x.png",
		"category_id": "electronics",
		"quantity":1,
		"unit_price":58.80
	}
        ],
        "payer": {
            "phone": {
                "area_code": "11",
                "number": "987654321"
            },
            "address": {
                "zip_code": "06233-200",
                "street_name": "Av das Nacoes Unidas",
                "street_number": "3003"
            },
            "first_name": "Nome",
            "last_name": "Sobrenome",
            "registration_date": "2019-01-01T12:01:01.000-03:00"
        },
        "shipments": {
        	"receiver_address":{
			"street_name":"Av das Nacoes Unidas",
			"street_number":3003,
			"zip_code":"06233200",
			"city_name": "Buzios",
			"state_name": "Rio de Janeiro"
		}
        }
    },
    "order": {},
    "external_reference": "MP0001",
    "transaction_amount": 58.8,
    "transaction_amount_refunded": 0,
    "coupon_amount": 0,
    "differential_pricing_id": null,
    "deduction_schema": null,
    "transaction_details": {
        "payment_method_reference_id": null,
        "net_received_amount": 56.16,
        "total_paid_amount": 58.8,
        "overpaid_amount": 0,
        "external_resource_url": null,
        "installment_amount": 58.8,
        "financial_institution": null,
        "payable_deferral_period": null,
        "acquirer_reference": null
    },
    "fee_details": [
        {
            "type": "mercadopago_fee",
            "amount": 2.64,
            "fee_payer": "collector"
        }
    ],
    "captured": true,
    "binary_mode": false,
    "call_for_authorize_id": null,
    "statement_descriptor":"MercadoPago",
    "installments": 1,
    "card": {
        "id": null,
        "first_six_digits": "423564",
        "last_four_digits": "5682",
        "expiration_month": 6,
        "expiration_year": 2023,
        "date_created": "2019-07-10T10:47:58.000-04:00",
        "date_last_updated": "2019-07-10T10:47:58.000-04:00",
        "cardholder": {
            "name": "APRO",
            "identification": {
                "number": "19119119100",
                "type": "CPF"
            }
        }
    },
    "notification_url": "https://www.suaurl.com/notificacoes/",
    "refunds": [],
    "processing_mode": "aggregator",
    "merchant_account_id": null,
    "acquirer": null,
    "merchant_number": null,
    "acquirer_reconciliation": []
}
 

Error Codes

CodeDescription

Sua pesquisa não retorna resultados.

Check the spelling of search terms or test with other keywords.