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 -X POST \
'https://api.mercadopago.com/preapproval'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-2151****' \
-H '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": "{{CARD_TOKEN}}",
"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 momento en que se cobre la cuota pueden surgir tres alternativas en base al resultado de su pago:
El pago es realizado exitosamente por lo que la cuota quedarĂĄ
processed
y ya no se reintentarĂĄ cobrarla.El pago se estĂĄ procesando por lo que la cuota quedarĂĄ en
waiting for gateway
hasta que se resuelva el pago.El pago es rechazado por lo que la cuota quedarĂĄ en
recycling
siempre y cuando no esté expirada o no haya alcanzado el måximo de reintentos. Caso contrario, quedarå enprocessed
.
Pagos rechazados
Cuando una cuota queda en el estado recycling
entra en un esquema de reintentos con un mĂĄximo de 4 posibilidades, en los que se vuelve a realizar el cobro de la cuota. El resultado puede ser cualquiera de los dos puntos mencionados arriba.
Si el pago resulta rechazado, se actualiza a una nueva fecha de cobro sumando 1 de las 4 posibilidades dentro de los diez dĂas como ventana de tiempo de reintento a la Ășltima fecha de disponible.
Por defecto se reintenta dentro de una ventana de 10 dĂas. En caso de que la cuota tenga fecha de expiraciĂłn, la ventana de tiempo se ajusta a esa fecha y mantiene la lĂłgica de 4 reintentos.
Pagos en proceso
Si una cuota se encuentra en el estado waiting for gateway
, y cuando se resuelve el pago resulta rechazada y se cumpliĂł la fecha de expiraciĂłn, la cuota automĂĄticamente pasarĂĄ a ser procesada con el estado processed
. Caso contrario, entrarĂĄ al esquema de reintento.
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.