Búsqueda inteligente powered by OpenAI
Actualizar suscripción
PUT
Productos que lo utilizan:
Parámetros para la solicitud
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
Parámetros de respuesta
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
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-8971*********918-01191*********5874530a4*********4799fdf-1*********' \
-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"
}'
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",
"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"
}