/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 Identificador del pagador.
entity_type String Tipo de entidad del pagador (sólo para transferencias bancarias).
individual El pagador es único.
association El pagador es una asociación.
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.
guest El pagador no tiene una cuenta.
id String Identificación del pagador asociado.
email String Email. (Obligatorio)
identification Object Identificación personal.
type String Tipo de identificación.
number String Número de identificación.
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.
binary_mode Boolean Cuando está activado el pago solo puede resultar aprobado o rechazado. De no estar activado, además de este estado el pago puede resultar pendiente (in_process).
order Object Identificador de orden.
type String Tipo de orden.
mercadolibre La orden es de Mercado Libre.
mercadopago Es una merchant_order de Mercado Pago.
id Long Identificador de la orden de compra asociada.
external_reference String Identificador provisto por el vendedor en su sistema.
description String Razón de pago o título de ítem.
metadata Object JSON válido que puede agregarse al pago para guardar atributos adicionales del comprador.
transaction_amount Float Costo del producto. (Obligatorio)
coupon_amount Float Monto del cupón de descuento.
date_of_expiration Date(ISO_8601) Fecha de expiración del pago.
campaign_id Integer Identificador de la campaña de descuento.
coupon_code String Campaña de descuento con un código específico.
differential_pricing_id Integer Identificador del esquema de absorción del costo financiero.
application_fee Float Comisión recolectada por el marketplace o por Mercado Pago.
capture Boolean Determina si el pago debe ser capturado(true, default value) o solo reservado(false).
payment_method_id String Medio de pago elegido para hacer el pago. (Obligatorio)
issuer_id String Identificador del emisor del medio de pago.
token String Identificador de card token. (Obligatorio para tarjeta de crédito)
statement_descriptor String Cómo aparecerá el pago en el resumen de tarjeta (ej.: MERCADOPAGO).
installments Integer Cantidad seleccionada de cuotas. (Obligatorio)
notification_url String URL a la cual Mercado Pago enviará notificaciones asociadas a cambios en el estado del pago.
callback_url String URL a la cual Mercado Pago hace la redirección final (sólo para transferencia bancaria).
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 infomació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.
address Object Dirección.
zip_code String Código postal.
street_name String Calle.
street_number Integer Número.
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 Zip code.
state_name String Provincia.
city_name String Ciudad.
street_name String Calle.
street_number Integer Número.
floor String Piso.
apartment String Departmento.
barcode Object Información de código de barra.
type String Tipo de encoding.
UCC/EAN 128 Codifica data utilizando la simbología 128.
Code128C Código alfanumérico de alta densidad.
Code39 Código de densidad multimedia.
content String Código de barras generado.
width Integer Ancho del código de barras.
height Integer Altura del 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

La búsqueda no arrojó ningún resultado.

Verifica la la ortografía de los términos de búsqueda o prueba con otras palabras clave.