/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
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.
23
El siguiente parámetro debe ser una fecha válida en formato (yyyy-MM-dd'T'HH:mm:ssz) date_of_expiration.
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.
7523
Fecha de expiración inválida.