Suscripciones sin plan asociado
Las suscripciones sin plan asociado se utilizan cuando distintas suscripciones tienen características diferentes por ser específicas de cada pagador. Por ejemplo: una suscripción de un solo mes con un descuento específico.
Este modelo de suscripción se puede realizar de dos formas:
Suscripciones con pago autorizado
Las suscripciones con pago autorizado permiten generar y facturar la cuota de una suscripción en función de la periodicidad definida, lo que hace que el motor de suscripciones programe y cree automáticamente pagos en función del método de pago definido en el momento de la creación de la firma.
Para ofrecer suscripciones sin plan asociado y con pago autorizado, envía un POST con los atributos necesarios al endpoint /preapproval y presta atención al parámetro status
, que debe ser rellenado con el valor authorized
. Si prefieres, usa el curl a continuación.
curl --location --request POST 'https://api.mercadopago.com/preapproval?access_token=APP_USR-????????' \
--header 'Content-Type: application/json' \
--header 'X-scope: stage' \
--data-raw '{
"back_url": "https://www.google.com",
"reason": "Test Subscription",
"auto_recurring": {
"frequency": 1,
"frequency_type": "months",
"start_date": "2020-06-02T13:07:14.260Z",
"end_date": "2022-07-20T15:59:52.581Z",
"transaction_amount": 10,
"currency_id": "ARS"
},
"payer_email": "test_user+1020927396@testuser.com",
"card_token_id": "{{EL_CARD_TOKEN_QUE_CREASTE}}",
"status": "authorized"
}'
Después de completar los campos, ejecuta el request.
Lógica de reintentos de cobro
Al automatizar la recurrencia de tus cobros, se crean pagos autorizados que tendrán una fecha de débito configurada en base a la periodicidad que se definió en la suscripción. Luego de suscribirse, el pago de la primera cuota se acreditará en 1 hora.
Estados de pago
En el caso de que no se pueda cobrar la cuota en el cuarto reintento, la cuota automáticamente quedará en el estado processed
asociada a un pago rechazado.
Luego de 3 cuotas con pagos rechazados se da de baja automáticamente la suscripción y la cuenta del vendedor será notificada de la cancelación de la suscripción por e-mail.
Suscripciones con pago pendiente
Las suscripciones con pago pendiente son un modelo de suscripción donde no se define un método de pago en el momento de su creación. Cuando esto ocurre, los pagos pasan automáticamente al estado pending
y dependen de que el usuario busque una forma de completar el pago.
En este caso, es posible actualizar la suscripción y definir un medio de pago a través del endpoint /preapproval/{id}, o compartir un link de pago para que el comprador pueda completar la compra con el método de pago de su elección.
Para ofrecer suscripciones sin plan asociado y con pago pendiente, envía un POST con los atributos necesarios al endpoint /preapproval y presta atención al parámetro status
, que debe ser rellenado con el valor pending
. Si prefieres, usa el curl a continuación.
curl --location --request POST 'https://api.mercadopago.com/preapproval' \
--header 'Authorization: Bearer YOU_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
"reason": "Yoga classes",
"external_reference": "YG-1234",
"payer_email": "test_user_75650838@testuser.com",
"auto_recurring": {
"frequency": 1,
"frequency_type": "months",
"end_date": "2023-07-20T15:59:52.581Z",
"transaction_amount": 10,
"currency_id": "BRL"
},
"back_url": "https://www.yoursite.com",
"status": "pending"
}'