Actualizar suscripción - Suscripciones - Mercado Pago Developers
¿Qué estás buscando?

¿No sabes cómo empezar la integración? 

Accede a los primeros pasos
Actualizar suscripción

PUT

https://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..
Parámetros para la solicitud
PATH
id
string

REQUERIDO

Identificador único de suscripción que deseas modificar.
BODY
auto_recurring
object
Información de configuración para la recurrencia.
back_url
string
URL de retorno exitosa. Use esta configuración para redirigir a tus clientes después de nuestro checkout a tu sitio.
card_token_id
number
Identificador único para recuperar datos de la tarjeta utilizada como medio de pago.
external_reference
string
Referencia para sincronizar con tu sistema. Este es un campo de texto libre para ayudarte con tu integración para vincular las entidades.
Parámetros de respuesta
id
string
Identificador único de suscripción.
version
number
How many times the subscription was modified
application_id
number
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.
collector_id
number
ID único que identifica a tu usuario como vendedor. Este ID coincide con tu User ID en nuestro ecosistema.
Errores

400Error

400

Bad-request

401Error

401

Unauthorized

500Error

500

Error

Solicitud
curl -X PUT \
      'https://api.mercadopago.com/preapproval/{id}'\
       -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
       -d '{
  "auto_recurring": {
    "transaction_amount": 10,
    "currency_id": "ARS"
  },
  "back_url": "https://www.mercadopago.com.ar",
  "card_token_id": 123123123,
  "external_reference": 23546246234,
  "reason": "Yoga classes.",
  "status": "pending"
}'
Respuesta de ejemplo
{
  "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",
  "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"
}