Migration from V1 to V0
As of March 8, 2022 a new version of the signature engine related to the entities below will be available with new features.
- Plan (identified by /v1/plan in v1 and now by
preapproval_plan
in v0) - Subscription (identified by /v1/subscriptions in v1 and now by
preapproval
in v0) - Invoice (identified by /v1/invoices in v1 and now by
authorized_payments
in v0)
The new version has a superior architecture with much more functionality and has email notifications sent with each status update at:
- Subscriptions (creation and cancellation);
- Subscription charge;
- Change of plans.
In addition to email notifications, the new version also has Webhooks for plans
, subscriptions
and invoices
.
Migration
Migration to this engine is required, as version 1 will no longer be available from March 8, 2022 onwards.
The migration will happen automatically and all migrated plans, subscriptions and invoices will remain active with a new ID. To verify the new migrated IDs, you can use the endpoint below which will remain public at your disposal until July 2022.
Once you have the new ID, you can update your plan IDs, subscriptions and invoices as you wish.
curl --location
--request GET 'https://api.mercadopago.com/subscriptions/migrations/<RESOURCE>/<ID>
- | Resource | ID |
Request | plan subscription invoice | Unique identifier |
Response | preapproval preapproval_plan authorized_payment | Unique identifier |