Inicio
Documentación
Recursos
Certificaciones
Comunidad

Recursos

Revisa las actualizaciones de nuestras soluciones y operatividad del sistema o pide soporte técnico.

Comunidad

Recibe las últimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

Crear pago - Pagos - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

Crear pago

POST

https://api.mercadopago.com/v1/payments
Este endpoint permite crear un pago e incluir toda la información necesaria. Asegúrese de añadir los detalles del pago y la información del cliente. En caso de éxito, la solicitud devolverá una respuesta con el estado 201.
Parámetros para la solicitud
HEADER
X-Idempotency-Key
string

REQUERIDO

Esta función permite repetir solicitudes de manera segura, sin el riesgo de realizar la misma acción más de una vez por error. Esto es útil para evitar errores, como la creación de dos pagos idénticos, por ejemplo. Para ...Ver más
BODY
additional_info
object
En el nivel de Pagos, son solo datos y únicamente reenviamos esa información a otras API, como Riesgo, para realizar puntajes y prevenir fraudes, o a Impuestos, para determinarlos para pagos internacionales.
application_fee
number
Comisión (fee) que los terceros (integradores) cobran a sus clientes, en este caso vendedores, por utilizar la plataforma del marketplace y otros servicios. Este es un valor en reales que será definido por el integrador ...Ver más
binary_mode
boolean
Cuando se configura como TRUE los pagos sólo pueden resultar aprobados o rechazados. Caso contrario también pueden resultar in_process.
callback_url
string
URL a la cual Mercado Pago hace la redirección final (sólo para transferencia bancaria).
Parámetros de respuesta
id
number
Identificador único del pago, generado automáticamente por Mercado Pago.
date_created
string
Fecha de creación del pago.
date_approved
string
Fecha de aprobación del Pago. Un pago puede generarse en un estado intermedio y luego ser aprobado, por tanto la fecha de creación no siempre coincidirá con la Fecha de Aprobación.
date_last_updated
string
Fecha en la que se registró el ultimo evento sobre el pago.
Errores

400Error

1

Params Error. - Si aparece este error, por favor verifique los parámetros enviados en la solicitud.

3

Token must be for test. - Si ocurre este error, asegúrese de estar usando un token de prueba.

8

The name of the following parameters is wrong [additional_info.payer.test] - Este error se muestra cuando el nombre de un determinado parámetro se introduce incorrectamente. En este ejemplo, el campo `additional_info.payer`. Revise el parámetro devuelto en el error y asegúrese de que la información introducida sea correcta.

23

The following parameters must be valid date and format (yyyy-MM-dd'T'HH:mm:ssz) date_of_expiration. - Si surge este error, asegúrese de que la fecha de expiración esté en el formato correcto.

1000

Number of rows exceeded the limits. - Si encuentra este error, reduzca el número de filas en su solicitud.

2002

Customer not found. - Verifique los detalles del cliente e intente nuevamente si encuentra este error.

2004

POST to Gateway Transactions API fail. - Si ocurre este error, verifique el endpoint de la API y vuelva a intentarlo.

2006

Card Token not found. - Si ve este error, asegúrese de que el token de la tarjeta sea correcto y válido.

2007

Connection to Card Token API fail. - Verifique su conexión de red y vuelva a intentarlo si aparece este error.

2009

Card token issuer can't be null. - Asegúrese de que se proporcione el emisor del token de tarjeta si ocurre este error.

2034

Invalid users involved. - Si aparece este error, asegúrese de que todos los usuarios involucrados sean productivos o de prueba. Además, verifique que el sponsor_id (si corresponde) sea correcto e intente nuevamente.

2059

You cannot use `application_fee` with this payment. - Este error ocurre porque el Access Token en uso no fue obtenido mediante OAuth. Asegúrese de utilizar un Access Token generado a través de OAuth.

2062

Invalid card token. - Asegúrese de que el token de tarjeta proporcionado sea válido y correcto si ocurre este error.

2067

Invalid user identification number. - Verifique el número de identificación del usuario e intente nuevamente si encuentra este error.

2072

Invalid value for transaction_amount. - Asegúrese de que el transaction_amount sea válido si aparece este error.

2077

Deferred capture not supported. - Si ocurre este error, tenga en cuenta que la captura diferida no es compatible y ajuste su solicitud en consecuencia.

2123

Invalid operators users involved. - Si ve este error, verifique los operadores involucrados en la transacción.

2131

Cannot infer Payment Method. - Verifique que el campo `payment_method` esté correctamente completado y coincida con el medio de pago utilizado, así como el número de cuotas (`installments`).

2198

Invalid test user email. - Este error ocurre cuando el atributo payer.email se envía utilizando un correo electrónico que no es de prueba mientras se encuentra en un entorno de prueba (por ejemplo, utilizando un correo electrónico @testuser.com). Si encuentra este error, verifique que realmente se encuentre en un entorno de prueba y, de ser así, utilice un correo electrónico como se especifica.

3000

You must provide your cardholder_name with your card data. - Si ocurre este error, incluya el cardholder_name en su solicitud.

3001

You must provide your cardissuer_id with your card data. - Si encuentra este error, asegúrese de que el cardissuer_id esté incluido en su solicitud.

3003

Invalid card_token_id. - Asegúrese de que el card_token_id sea correcto y no haya sido utilizado anteriormente. Intente nuevamente.

3004

Invalid parameter site_id. - Si ocurre este error, asegúrese de que el site_id sea válido y esté correctamente formateado.

3005

Not valid action, the resource is in a state that does not allow this operation. For more information see the state that has the resource. - Si ve este error, verifique el estado del recurso y ajuste su solicitud en consecuencia.

3006

Invalid parameter cardtoken_id. - Asegúrese de que el cardtoken_id sea correcto e intente nuevamente si aparece este error.

3007

The parameter client_id cannot be null or empty. - Si ocurre este error, proporcione un client_id válido.

3008

Not found Cardtoken. - Verifique la información del cardtoken e intente nuevamente si aparece este error.

3009

Unauthorized client_id. - Si ocurre este error, verifique los permisos del client_id e intente nuevamente.

3010

Not found card on whitelist. - Asegúrese de que la tarjeta esté en la lista blanca si aparece este error.

3011

Not found payment_method. - Verifique la información del payment_method e intente nuevamente si ocurre este error.

3012

Invalid parameter security_code_length. - Asegúrese de que el parámetro security_code_length sea correcto si aparece este error.

3013

The parameter security_code is a required field and cannot be null or empty. - Si ocurre este error, proporcione el parámetro security_code.

3014

Invalid parameter payment_method. - Asegúrese de que el parámetro payment_method sea correcto si aparece este error.

3015

Invalid parameter card_number_length. - Si ocurre este error, asegúrese de que el parámetro card_number_length sea correcto.

3016

Invalid parameter card_number. - Verifique el parámetro card_number e intente nuevamente si aparece este error.

3017

The parameter card_number_id cannot be null or empty. - Asegúrese de que se proporcione el parámetro card_number_id si ocurre este error.

3018

The parameter expiration_month cannot be null or empty. - Proporcione el parámetro expiration_month si ocurre este error.

3019

The parameter expiration_year cannot be null or empty. - Asegúrese de que se proporcione el parámetro expiration_year si aparece este error.

3020

The parameter cardholder.name cannot be null or empty. - Proporcione el parámetro cardholder.name si ocurre este error.

3021

The parameter cardholder.document.number cannot be null or empty. - Asegúrese de que se proporcione el parámetro cardholder.document.number si aparece este error.

3022

The parameter cardholder.document.type cannot be null or empty. - Proporcione el parámetro cardholder.document.type si ocurre este error.

3023

The parameter cardholder.document.subtype cannot be null or empty. - Asegúrese de que se proporcione el parámetro cardholder.document.subtype si aparece este error.

3024

Not valid action - partial refund unsupported for this transaction. - Si ocurre este error, tenga en cuenta que los reembolsos parciales no están soportados para esta transacción.

3025

Invalid Auth Code. - Verifique el código de autenticación e intente nuevamente si aparece este error.

3026

Invalid card_id for this payment_method_id. - Asegúrese de que el card_id coincida con el payment_method_id si ocurre este error.

3027

Invalid payment_type_id. - Si aparece este error, verifique el payment_type_id e intente nuevamente.

3028

Invalid payment_method_id. - Verifique el payment_method_id e intente nuevamente si ocurre este error.

3029

Invalid card expiration month. - Asegúrese de que el mes de expiración de la tarjeta sea válido si aparece este error.

3030

Invalid card expiration year. - Si ocurre este error, verifique el año de expiración de la tarjeta e intente nuevamente.

3031

Secure_code_id can't be null. - Asegúrese de que el secure_code_id esté proporcionado si aparece este error.

3032

Invalid security_code_length 3033 3034 - Invalid card_number_validation. - Si ocurre este error, verifique la longitud del código de seguridad y la validación del número de tarjeta.

4000

Token attribute can't be null. - Asegúrese de que el atributo token esté proporcionado si aparece este error.

4001

Payment_method_id attribute can't be null. - Si ocurre este error, proporcione el atributo payment_method_id.

4002

Transaction_amount attribute can't be null. - Asegúrese de que el atributo transaction_amount esté proporcionado si aparece este error.

4003

Transaction_amount attribute must be numeric. - Verifique que el transaction_amount sea numérico si ocurre este error.

4004

Installments attribute can't be null. - Si aparece este error, asegúrese de que el atributo installments esté proporcionado.

4005

Installments attribute must be numeric. - Asegúrese de que el atributo installments sea numérico si ocurre este error.

4006

Payer attribute is malformed. - Verifique que el atributo payer esté correctamente formateado si aparece este error.

4012

Payer.id attribute can't be null. - Si aparece este error, asegúrese de que el atributo payer.id esté proporcionado.

4013

Payer.type attribute can't be null. - Asegúrese de que el atributo payer.type esté proporcionado si ocurre este error.

4015

Payment_method_reference_id attribute can't be null. - Proporcione el atributo payment_method_reference_id si aparece este error.

4016

Payment_method_reference_id attribute must be numeric. - Asegúrese de que el atributo payment_method_reference_id sea numérico si ocurre este error.

4017

Status attribute can't be null. - Si aparece este error, asegúrese de que el atributo status esté proporcionado.

4018

Payment_id attribute can't be null. - Proporcione el atributo payment_id si ocurre este error.

4019

Payment_id attribute must be numeric. - Asegúrese de que el atributo payment_id sea numérico si aparece este error.

4020

Notification_url attribute must be a valid URL. - Si ocurre este error, proporcione una URL válida para el atributo `notification_url` que comience con `https://`.

4021

Notification_url attribute must be shorter than 500 characters. - Asegúrese de que el atributo notification_url esté dentro del límite de caracteres si aparece este error.

4022

Metadata attribute must be a valid JSON. - Si ocurre este error, asegúrese de que el atributo metadata sea un JSON válido.

4023

Transaction_amount attribute can't be null. - Proporcione el atributo transaction_amount si aparece este error.

4024

Transaction_amount attribute must be numeric. - Asegúrese de que el atributo transaction_amount sea numérico si ocurre este error.

4025

Refund_id can't be null. - Proporcione el refund_id si aparece este error.

4026

Invalid coupon_amount. - Verifique que la cantidad del cupón sea correcta si ocurre este error.

4027

Campaign_id attribute must be numeric. - Asegúrese de que el atributo campaign_id sea numérico si aparece este error.

4028

Coupon_amount attribute must be numeric. - Verifique que el atributo coupon_amount sea numérico si ocurre este error.

4029

Invalid payer type. - Asegúrese de que el tipo de pagador sea válido si aparece este error.

4033

Invalid installments. - Verifique que el parámetro de cuotas sea correcto si ocurre este error.

4037

Invalid transaction_amount. - Asegúrese de que el monto de la transacción sea válido si aparece este error.

4038

Application_fee cannot be bigger than transaction_amount. - Si ocurre este error, asegúrese de que la tarifa de aplicación sea menor o igual al monto de la transacción.

4039

Application_fee cannot be a negative value. - Asegúrese de que la tarifa de aplicación sea un valor positivo si aparece este error.

4050

Payer.email must be a valid email. - Si ocurre este error, asegúrese de que el payer.email sea una dirección de email válida.

4051

Payer.email must be shorter than 254 characters. - Asegúrese de que el payer.email esté dentro del límite de caracteres si aparece este error.

4292

Header X-Idempotency-Key can’t be null. - Proporcione un encabezado X-Idempotency-Key válido si ocurre este error.

6033

User unavailable. - Si aparece este error, verifique el estado del usuario y vuelva a intentarlo.

7523

Invalid expiration date. - Asegúrese de que la fecha de expiración sea válida si ocurre este error.

401Error

Unauthorized use of live credentials

Este error ocurre cuando el token de acceso no tiene el alcance 'payment' necesario. Verifique que las credenciales sean correctas y que tengan los permisos adecuados.

403Error

4

El caller no está autorizado para acceder a este recurso. - Si ocurre este error, verifique sus permisos de acceso.

3002

El caller no está autorizado para realizar esta acción. - Si ve este error, asegúrese de tener los permisos necesarios para realizar esta acción.

pa_unauthorized_result_from_policies

blocked_by PolicyAgent - At least one policy returned unauthorized - Este error ocurre cuando al menos una política devuelve 'unauthorized'. Esto puede suceder si el header de `authorization` se elimina durante la solicitud o si no se envía el Access Token. Verifique el envío de esta información e intente hacer una nueva solicitud.

Solicitud
curl -X POST \
    'https://api.mercadopago.com/v1/payments'\
    -H 'Content-Type: application/json' \
       -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
       -H 'Authorization: Bearer TEST-5599*********291-02171*********139a4791e*********f7f5835-1*********' \
    -d '{
  "additional_info": {
    "items": [
      {
        "id": "MLB2907679857",
        "title": "Point Mini",
        "description": "Point product for card payments via Bluetooth.",
        "picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
        "category_id": "electronics",
        "quantity": 1,
        "unit_price": 58,
        "type": "electronics",
        "event_date": "2023-12-31T09:37:52.000-04:00",
        "warranty": false,
        "category_descriptor": {
          "passenger": {},
          "route": {}
        }
      }
    ],
    "payer": {
      "first_name": "Test",
      "last_name": "Test",
      "phone": {
        "area_code": 11,
        "number": "987654321"
      },
      "address": {
        "street_number": null
      }
    },
    "shipments": {
      "receiver_address": {
        "zip_code": "12312-123",
        "state_name": "Rio de Janeiro",
        "city_name": "Buzios",
        "street_name": "Av das Nacoes Unidas",
        "street_number": 3003
      },
      "width": null,
      "height": null
    }
  },
  "application_fee": null,
  "binary_mode": false,
  "campaign_id": null,
  "capture": false,
  "coupon_amount": null,
  "description": "Payment for product",
  "differential_pricing_id": null,
  "external_reference": "MP0001",
  "installments": 1,
  "metadata": {},
  "payer": {
    "entity_type": "individual",
    "type": "customer",
    "id": null,
    "email": "test_user_123@testuser.com",
    "identification": {
      "type": "CPF",
      "number": "95749019047"
    }
  },
  "payment_method_id": "master",
  "token": "ff8080814c11e237014c1ff593b57b4d",
  "transaction_amount": 58
}'
Respuesta de ejemplo
{
  "id": 20359978,
  "date_created": "2019-07-10T14:47:58.000Z",
  "date_approved": "2019-07-10T14:47:58.000Z",
  "date_last_updated": "2019-07-10T14:47:58.000Z",
  "money_release_date": "2019-07-24T14:47:58.000Z",
  "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.",
  "taxes_amount": 0,
  "shipping_amount": 0,
  "collector_id": 448876418,
  "payer": {
    "id": 123,
    "email": "test_user_80507629@testuser.com",
    "identification": {
      "number": 19119119100,
      "type": "CPF"
    },
    "type": "customer"
  },
  "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_medium2x.png",
        "category_id": "electronics",
        "quantity": 1,
        "unit_price": 58
      }
    ],
    "payer": {
      "registration_date": "2019-01-01T15:01:01.000Z"
    },
    "shipments": {
      "receiver_address": {
        "street_name": "Av das Nacoes Unidas",
        "street_number": 3003,
        "zip_code": 6233200,
        "city_name": "Buzios",
        "state_name": "Rio de Janeiro"
      }
    }
  },
  "external_reference": "MP0001",
  "transaction_amount": 58,
  "transaction_amount_refunded": 50,
  "coupon_amount": 15,
  "transaction_details": {
    "net_received_amount": 56,
    "total_paid_amount": 58,
    "overpaid_amount": 0,
    "installment_amount": 58
  },
  "fee_details": [
    {
      "type": "coupon_fee",
      "amount": 2,
      "fee_payer": "payer"
    }
  ],
  "statement_descriptor": "MercadoPago",
  "installments": 1,
  "card": {
    "first_six_digits": 423564,
    "last_four_digits": 5682,
    "expiration_month": 6,
    "expiration_year": 2023,
    "date_created": "2019-07-10T14:47:58.000Z",
    "date_last_updated": "2019-07-10T14:47:58.000Z",
    "cardholder": {
      "name": "APRO",
      "identification": {
        "number": 19119119100,
        "type": "CPF"
      }
    }
  },
  "notification_url": "https://www.suaurl.com/notificacoes/",
  "processing_mode": "aggregator",
  "point_of_interaction": {
    "type": "PIX",
    "application_data": {
      "name": "NAME_SDK",
      "version": "VERSION_NUMBER"
    },
    "transaction_data": {
      "qr_code_base64": "iVBORw0KGgoAAAANSUhEUgAABRQAAAUUCAYAAACu5p7oAAAABGdBTUEAALGPC/xhBQAAAAFzUkdCAK7OHOkAAAAgY0hSTQAAeiYAAICEAAD6AAAAgOgAAHUwAADqYAAAOpgAABdwnLpRPAAAIABJREFUeJzs2luO3LiWQNFmI+Y/Zd6vRt36KGNXi7ZOBtcagHD4kNLeiLX33v8DAAAAABD879sDAAAAAAA/h6AIAAAAAGSCIgAAAACQCYoAAAAAQCYoAgAAAACZoAgAAAAAZIIiAAAAAJAJigAAAABAJigCAAAAAJmgCAAAAABkgiIAAAAAkAmKAAAAAEAmKAIAAAAAmaAIAAAAAGSCIgAAAACQCYoAAAAAQCYoAgAAAACZoAgAAAAAZIIiAAAAAJAJigAAAABAJigCA...",
      "qr_code": "00020126600014br.gov.bcb.pix0117test@testuser.com0217dados adicionais520400005303986540510.005802BR5913Maria Silva6008Brasilia62070503***6304E2CA",
      "ticket_url": "https://www.mercadopago.com.br/payments/123456789/ticket?caller_id=123456&hash=123e4567-e89b-12d3-a456-426655440000"
    }
  }
}