A partir de las nuevas reglas operacionales para la tokenización de operaciones de pagos recurrentes de las marcas Visa y Master, será necesario enviar el identificador de transacción de la tarjeta (TID) a las transacciones de mensajería para que se utilice dentro de la multiadquirencia y evitar posibles multas.

Para el primer pago, envía el header X-Expand-Responde-Nodes al endpoint v1/payments como se muestra a continuación.

json
Copiar
--header 'X-Expand-Responde-Nodes: gateway.reference'\

En la respuesta se podrá observar el retorno del network_transaction_id en el parámetro expanded. Ejemplo:

json
Copiar
"expanded": {
   "gateway": {
 	  "reference": {
 		 "network_transaction_id": "n7w-c0d3-t7d"
 	    }
    }
}

Para los pagos subsecuentes, envía nuevamente el header X-Expand-Responde-Nodes al endpoint v1/payments como se muestra a continuación.

json
Copiar
--header 'X-Expand-Responde-Nodes: gateway.reference'\

En la respuesta, observa el retorno del network_transaction_id en el parámetro expanded y, a partir de eso, envía la información del network_transaction_id devuelto en el último pago realizado al endpoint v1/payments, a través del parámetro forward_data, o utilizando el cURL a continuación.

curl
Copiar
curl --location 'https://api.mercadopago.com/v1/payments' \
--header 'Authorization: Bearer ENV_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
    "description": "{{description}}",
    "token": "{{card_token}}",
    "payer": {
        "id": "{{customer_id}}",
        "type": "{{type}}"
    },
    "payment_method_id": "{{payment_method_id}}",
    "transaction_amount": {{transaction_amount}},
    "point_of_interaction": {
        "type": "{{type}}",
        "transaction_data": {
            "first_time_use": {{first_time_use}},
            "subscription_id": "{{subscription_id}}",
            "subscription_sequence": {
                "number": {{subscription_number}},
                "total": {{subscription_total}}
            },
            "invoice_period": {
                "period": {{invoice_period}},
                "type": "{{invoice_type}}"
            },
            "billing_date": "{{billing_date}}",
            "user_present": {{user_present}}
        }
    },
    "forward_data": {
        "network_transaction_data": {
            "network_transaction_id": "{{network_transaction_id}}"
        }
    }
}'

Ejemplo:

json
Copiar
{
    "description": "TESTE",
    "external_reference": "MP_genova_master",
    "installments": 1,
    "token": "{{token}}",
    "payer": {
        "id": "{{customer_id}}",
        "entity_type": "individual",
        "type": "customer"
    },
    "payment_method_id": "master",
    "transaction_amount": 1,
    "point_of_interaction": {
        "type": "SUBSCRIPTIONS",
        "transaction_data": {
            "first_time_use": true,
            "subscription_id": "mlb-suscripcions-genova-1",
            "subscription_sequence": {
                "number": 1
            },
            "invoice_period": {
                "period": 1,
                "type": "monthly"
            },
            "billing_date": "2024-07-29",
            "user_present": true
        }
    },
    "forward_data": {
        "network_transaction_data": {
            "network_transaction_id": "n7w-c0d3-t7d"
        }
    }
}

Respuesta:

json
Copiar
"expanded": {
   "gateway": {
 	  "reference": {
 		 "network_transaction_id": "n7w-c0d3-t7d"
 	    }
    }
}