Assinaturas sem plano associado
Assinaturas sem plano associado é quando diferentes assinaturas possuem características distintas por serem específicas para cada pagador. Por exemplo: uma assinatura de um único mês com um desconto específico.
Este modelo de assinatura pode ser feito de duas maneiras:
Assinaturas com pagamento autorizado
Assinaturas com pagamento autorizado permitem que a parcela de uma assinatura seja gerada e cobrada com base na recorrência definida, fazendo com que o mecanismo de assinatura agende e crie os pagamentos automaticamente com base no meio de pagamento definido no ato da criação da assinatura.
Para oferecer assinaturas sem um plano associado e com pagamento autorizado, envie um POST com os atributos necessários ao endpoint /preapproval e atente-se ao parâmetro status
, que deverá ser preenchido com o valor authorized
. Se preferir, utilize o curl disponível abaixo.
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"
}'
Lógica de novas tentativas de cobrança
Ao automatizar a recorrência de suas cobranças, são criados pagamentos autorizados que terão uma data de débito configurada com base na periodicidade definida na assinatura. A primeira parcela é cobrada até o período aproximado de uma hora após a assinatura.
Status de pagamento
Caso a parcela não possa ser cobrada na quarta tentativa, ela estará automaticamente no status processed
associada a um pagamento recusado.
Após 3 parcelas com pagamentos recusados a assinatura será automaticamente cancelada e a conta do vendedor será notificada do cancelamento da assinatura por e-mail.
Assinaturas com pagamento pendente
Assinaturas com pagamento pendente são um modelo de assinaturas onde um meio de pagamento não é definido no momento de sua criação. Quando isso ocorre, os pagamentos automaticamente ficam com status pending
e dependem que o usuário busque uma forma de concluir o pagamento.
Neste caso, é possível atualizar a assinatura e definir um meio de pagamento através do endpoint /preapproval/{id}, ou compartilhar um link de pagamento para que o comprador possa concluir a compra com o meio de pagamento de sua preferência.
Para oferecer assinaturas sem um plano associado e com pagamento pendente, envie um POST com os atributos necessários ao endpoint /preapproval e atente-se ao parâmetro status
, que deverá ser preenchido com o valor pending
. Se preferir, utilize o curl disponível abaixo.
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"
}'