Essa informação foi útil?
Sim
Não
Atualizar assinatura/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
Produtos relacionados:
Parâmetros de requisição
idstring
Localização: pathIdentificador de assinatura exclusivo que deseja modificar.OBRIGATÓRIO
auto_recurring
Localização: bodyConfiguração da data para recorrência.object
back_url
Localização: bodyURL de retorno de sucesso. Use esta configuração para redirecionar seus clientes ao seu site após o checkout.string
card_token_id
Localização: bodyIdentificador único para recuperar dados do cartão utilizado como meio de pagamento.number
Parâmetros de resposta
id
Localização: bodyIdentificador único de assinaturastring
version
Localização: bodyHow many times the subscription was modifiednumber
application_id
Localização: bodyID ú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
Localização: bodyID único que identifica seu usuário como vendedor. Este ID corresponde ao seu User ID em nosso ecossistema.number
Solicitação
curl
curl -X PUT \
'https://api.mercadopago.com/preapproval/{id}' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN \
-H 'Content-Type: application/json' \
-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,
"status": "pending"
}'
Resposta
json
{
"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",
"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"
}
Erros
400bad_request
400
400You can not modify a cancelled preapproval.
400You can not modify a paused subscription.
400This preapproval can not be authorized with a credit card
400This preapproval can not disable account_money
400This preapproval can not be authorized only with account_money
400This preapproval require account_money to be authorized
400You must provide a card_id
400preapproval without another payment method
401bad_request
401Unauthorized access to resource
500bad_request
500Internal server error