Idempotencia - Flujo de pagos - Mercado Pago Developers

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.