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.

Idempotencia - Flujo de pagos - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

Idempotencia

Problemas de conexión o interrupciones del servicio pueden interferir en la comunicación al enviar o recibir datos para crear un pago.

Para garantizar la creación correcta de un pago, puedes realizar un nuevo intento de envío de los datos. Sin embargo, es posible que ya se haya creado el pago y debido a la interrupción no se haya recibido la respuesta correcta. Por lo que estos nuevos intentos crearán un nuevo pago.

Para evitar la duplicidad, es obligatorio enviar una clave única en el header X-Idempotency-Key que identifique la creación de un solo pago. De esta manera, cuando hagas un nuevo intento, puedes enviar la misma clave para indicar que es el mismo proceso.

Importante
Si el pago ya ha sido creado, se devolverá su información sin crear un nuevo pago.

A continuación se muestra el diagrama que ilustra el funcionamiento de la Idempotency Key en el proceso de creación de un pago.

idempotency-flow

Enviar request

          
curl -X POST \
    -H 'X-Idempotency-Key: IDEMPOTENCY_KEY' \
    -H 'Authorization: Bearer ACCESS_TOKEN'
    -H 'accept: application/json' \
    -H 'content-type: application/json' \
    'https://api.mercadopago.com/v1/advanced_payments' \
    -d '{
        "wallet_payment":{
           "transaction_amount":700.50,
           "description":"Payment Description",
           "external_reference":"Pago_123"     
        },
       "payer":{
           "token":"PAYER_TOKEN",
           "type_token": "wallet-token"
        }
      }'


        

Al ejecutar el request, puedes recibir diferentes tipos de respuestas originadas por razones específicas. Consulta la sección Respuestas para obtener más información.