Starting from the new operational rules for the tokenization of recurring payment transactions for the Visa and Master brands, it will be necessary to send the transaction identifier from the brand (TID) with messaging transactions to be used within multi-acquiring and avoid potential fines.

For the first payment, send the X-Expand-Responde-Nodes header to the endpoint v1/payments as indicated below.

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

In the response, you can observe the return of the network_transaction_id in the expanded parameter. Example:

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

For subsequent payments, send again the X-Expand-Responde-Nodes header to the endpoint v1/payments as indicated below.

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

In the response, note the return of the network_transaction_id in the expanded parameter and, based on that, send the information of the network_transaction_id returned in the last payment made to the endpoint v1/payments, via the forward_data parameter, or using the cURL below.

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}}"
        }
    }
}'

Example:

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"
        }
    }
}

Response:

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