Atualizar assinaturahttps://api.mercadopago.com/preapproval/{id}
Renove os dados de uma assinatura. Indique o ID da assinatura e envie o body com as informações que deseja atualizar. Você pode atualizar o motivo, valor, forma de pagamento, status e outras informações que compõem a assinatura.
PUT
Request parameters
Header
Authorization
Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.string
OBRIGATÓRIO
Path
id
Identificador de assinatura exclusivo que deseja modificar.string
OBRIGATÓRIO
Body
reason
É uma breve descrição que o assinante verá durante o processo de checkout e nas notificações. É obrigatório apenas para assinaturas sem plano associado.string
external_reference
Referência para sincronizar com seu sistema. Este é um campo de texto livre para ajudar com a integração para vincular as entidades.string
back_url
URL de retorno de sucesso. Use esta configuração para redirecionar seus clientes ao seu site após o checkout.string
auto_recurring
Configuração da data para recorrência.object
Response parameters
id
Identificador único de assinatura.string
version
Indica quantas vezes a assinatura foi modificada.number
application_id
ID único que identifica sua aplicação/integração. Uma das chaves do par que compõe as credenciais que identifica uma aplicação/integração na sua conta.number
collector_id
ID único que identifica seu usuário como vendedor. Este ID corresponde ao seu User ID em nosso ecossistema.number
Erros
400Erro
400
Bad-request
401Erro
401
Unauthorized
500Erro
500
Error
Request
curl -X PUT \
'https://api.mercadopago.com/preapproval/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
-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"
}'Response
{
"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"
}