Actualizar suscripciónhttps://api.mercadopago.com/preapproval/{id}
Renovar datos de suscripción. Ingrese el ID de suscripción y envÃe el body con la información que desea actualizar. Podrás actualizar el motivo, monto, medio de pago, status y demás información que conforma la suscripción.
PUT
Request parameters
Header
Authorization
Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.string
REQUERIDO
Path
id
Identificador único de suscripción que deseas modificar.string
REQUERIDO
Body
reason
Es una breve descripción que el suscriptor verá durante el proceso de checkout y en las notificaciones. Solo se requiere para suscripciones sin plan asociado.string
external_reference
Referencia para sincronizar con tu sistema. Este es un campo de texto libre para ayudarte con tu integración para vincular las entidades.string
back_url
URL de retorno exitosa. Use esta configuración para redirigir a tus clientes después de nuestro checkout a tu sitio.string
auto_recurring
Información de configuración para la recurrencia.object
Response parameters
id
Identificador único de suscripción.string
version
Indica cuántas veces fue modificada la suscripción.number
application_id
ID único que identifica tu aplicación/integración. Una de las claves del par que componen las credenciales que identifican una aplicación/integración en tu cuenta.number
collector_id
ID único que identifica a tu usuario como vendedor. Este ID coincide con tu User ID en nuestro ecosistema.number
Errors
400Error
400
Bad-request
401Error
401
Unauthorized
500Error
500
Error
Request
curl -X PUT \
'https://api.mercadopago.com/preapproval/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
-d '{
"reason": "Yoga classes.",
"external_reference": 23546246234,
"back_url": "https://www.mercadopago.com.ar",
"auto_recurring": {
"transaction_amount": 10,
"currency_id": "ARS"
},
"card_token_id": 123123123,
"card_token_id_secondary": 123123123,
"payment_method_id_secondary": "visa",
"status": "pending"
}'Response
{
"id": "2c938084726fca480172750000000000",
"version": 0,
"application_id": 1234567812345678,
"collector_id": 100200300,
"preapproval_plan_id": "2c938084726fca480172750000000000",
"reason": "Yoga classes.",
"external_reference": 23546246234,
"back_url": "https://www.mercadopago.com.ar",
"init_point": "https://www.mercadopago.com.ar/subscriptions/checkout?preapproval_id=2c938084726fca480172750000000000",
"auto_recurring": {
"frequency": 1,
"frequency_type": "months",
"start_date": "2020-06-02T13:07:14.260Z",
"end_date": "2022-07-20T15:59:52.581Z",
"currency_id": "ARS",
"transaction_amount": 10,
"free_trial": {
"frequency": 1,
"frequency_type": "months"
}
},
"first_invoice_offset": 7,
"payer_id": 123123123,
"card_id": 123123123,
"payment_method_id": "account_money",
"card_id_secondary": 123123123,
"payment_method_id_secondary": "visa",
"next_payment_date": "2022-01-01T11:12:25.892-04:00",
"date_created": "2022-01-01T11:12:25.892-04:00",
"last_modified": "2022-01-01T11:12:25.892-04:00",
"summarized": {
"quotas": 6,
"charged_quantity": 3,
"charged_amount": 1000,
"pending_charge_quantity": 1,
"pending_charge_amount": 200,
"last_charged_date": "2022-01-01T11:12:25.892-04:00",
"last_charged_amount": 100,
"semaphore": "green"
},
"status": "pending"
}