/v1/payments

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

HTTP Request

curl

 curl -X POST \
  'https://api.mercadopago.com/v1/payments?access_token=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"

    },
	"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",
			"picture_url":"https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium@2x.png",
			"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"
	}
   }
  }
}' 

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.
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": "BRL",
    "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": "32659430",
            "type": "DNI"
        },
        "phone": {
            "area_code": "01",
            "number": "1111-1111",
            "extension": ""
        },
        "type": "registered",
        "entity_type": null,
        "id": "448870796"
    },
    "metadata": {},
    "additional_info": {
        "items": [
            {
                "id": "PR0001",
                "title": "Point Mini",
                "description": null,
                "picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium@2x.png",
                "category_id": null,
                "quantity": "1",
                "unit_price": "58.8"
            }
        ],
        "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": {
                "zip_code": "06233200",
                "street_name": "Av das Nacoes Unidas",
                "street_number": "3003"
            }
        }
    },
    "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
404 NOT_FOUND
2000 No se ha encontrado el pago.
403 FORBIDDEN
4 El usuario no esta autorizado a acceder a este recurso.
3002 El usuario no está autorizado a realizar esta acción.
400 BAD_REQUEST
1 Error de parámetros.
3 El token debe ser para test.
5 Debes proveer tu access_token para proceder.
1000 El número de filas excede los límites.
1001 El formato de fecha debe ser yyyy-MM-dd'T'HH:mm:ss.SSSZ.
2001 Ya se posteó el mismo request en el último minuto.
2004 Falló el POST a Gateway Transactions API.
2002 Cliente no encontrado.
2006 Card Token no encontrado.
2007 Falló la conexión a Card Token API.
2009 Card token issuer no puede ser nulo.
2060 El cliente no puede ser igual al vendedor.
3000 Debes proveer el parámetro cardholder_name en card data.
3001 Debes proveer el parámetro cardholder_name en card data.
3003 card_token_id inválido.
3004 parameter site_id inválido.
3005 Acción inválida, el recurso esta en un estado que no permite esta operación. Para más información consulta el estado del recurso.
3006 cardtoken_id inválido.
3007 El parámetro client_id no puede ser nulo ni vacío.
3008 Cardtoken no encontrado.
3009 client_id no autorizado.
3010 La tarjeta no se encuentra en la lista blanca.
3011 payment_method no encontrado.
3012 security_code_length inválido.
3013 El parámetro security_code es requerido y no puede ser nulo ni vacío.
3014 payment_method inválido.
3015 card_number_length inválido.
3016 card_number inválido.
3017 El parámetro card_number_id no puede ser nulo ni vacío.
3018 El parámetro expiration_month no puede ser nulo ni vacío.
3019 El parámetro expiration_year no puede ser nulo ni vacío.
3020 El parámetro cardholder.name no puede ser nulo ni vacío.
3021 El parámetro cardholder.document.number no puede ser nulo ni vacío.
3022 El parámetro cardholder.document.type no puede ser nulo ni vacío.
3023 El parámetro cardholder.document.subtype no puede ser nulo ni vacío.
3024 Acción inválida, reembolsos parciales no soportados para esta transacción.
3025 Código de autorización inválido.
3026 card_id inválido para este payment_method_id.
3027 payment_type_id inválido.
3028 payment_method_id inválido.
3029 Mes de expiración de tarjeta inválido.
3030 Año de expiración de tarjeta inválido.
4000 El parámetro card no puede ser nulo.
4001 payment_method_id no puede ser nulo.
4002 transaction_amount no puede ser nulo.
4003 transaction_amount debe ser numérico
4004 installments no puede ser nulo.
4005 installments debe ser numérico.
4006 payer está mal formado.
4007 site_id no puede ser nulo.
4012 payer.id no puede ser nulo.
4013 payer.type no puede ser nulo.
4015 payment_method_reference_id no puede ser nulo.
4016 payment_method_reference_id debe ser numérico.
4017 status no puede ser nulo.
4018 payment_id no puede ser nulo.
4019 payment_id debe ser numérico.
4020 notificaction_url debe ser una url válida.
4021 notificaction_url debe tener una longitud menor a 500 caracteres.
4022 metadata debe ser un JSON válido.
4023 transaction_amount no puede ser nulo.
4024 transaction_amount debe ser numérico.
4025 refund_id no puede ser nulo.
4026 coupon_amount inválido.
4027 campaign_id debe ser numérico.
4028 coupon_amount atributte debe ser numérico.
4029 Tipo de payer inválido.
4037 transaction_amount inválido.
4038 application_fee no puede ser mayor que transaction_amount.
4039 application_fee no puede ser un valor negativo.
4050 payer.email debe ser un email válido.
4051 La longitud de payer.email debe ser menor que 254 caracteres.

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.