Inicio
DocumentaciĂłn
Recursos
Partners
Comunidad

Recursos

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

Partners

Conoce nuestro programa para agencias o desarrolladores que ofrecen servicios de integraciĂłn y vendedores que quieren contratarlos.

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-7434*********159-03141*********cee51edf8*********f94f589-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"
    }
  }
}