Criar uma assinatura - Preferência de assinatura

Criar uma assinatura - Preferência de assinatura - Mercado Pago Developers

Criar uma assinatura

POST

/preapproval

Gere uma assinatura com todas as configurações que você precisa.

Localização: bodyDados de recorrência de assinatura

Localização: bodyurl de retorno

Localização: bodyIdentificador de fornecedor

Localização: bodyValor de referência de assinatura

Localização: bodyid

Localização: bodypayer_id

Localização: bodypayer_email

Localização: bodyback_url

curl -X POST \
    'https://api.mercadopago.com/preapproval' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{
  "auto_recurring": {
    "frequency": 1,
    "frequency_type": "months",
    "transaction_amount": 10,
    "currency_id": "ARS",
    "start_date": "2020-06-02T13:07:14.260Z",
    "end_date": "2022-07-20T15:59:52.581Z"
  },
  "back_url": "https://www.mercadopago.com.ar",
  "external_reference": 23546246234,
  "payer_email": "test_user@testuser.com"
}'

{
  "id": "2c938084726fca480172750000000000",
  "payer_id": 123123123,
  "payer_email": "test_user@testuser.com",
  "back_url": "https://www.mercadopago.com.ar",
  "collector_id": 100200300,
  "application_id": 1234567812345678,
  "status": "pending",
  "reason": "Suscripcion Particular",
  "external_reference": 23546246234,
  "date_created": "2020-06-02T13:07:14.260Z",
  "last_modified": "2020-06-02T13:07:14.263Z",
  "init_point": "https://www.mercadopago.com/MLB/debits/new?preapproval_id=2c938084726fca480172750000000000",
  "sandbox_init_point": "https://sandbox.mercadopago.com/MLB/debits/new?preapproval_id=2c938084726fca480172750000000000",
  "auto_recurring": {
    "frequency": 1,
    "frequency_type": "months",
    "transaction_amount": 10,
    "currency_id": "ARS",
    "start_date": "2020-06-02T13:07:14.260Z",
    "end_date": "2022-07-20T15:59:52.581Z"
  },
  "version": 0
}

400bad_request

Card token was used, please generate newO token do cartão já foi usado, um novo deve ser criado.

Card token was generated without cvv validationPagamentos sem cvv não são aceitos.

Subscriptions are not available for this country yetAplicação de um site diferente de MLA ou MLB ou MLM.

The payment method account money is not available in your countryVocê não pode criar assinaturas com dinheiro em conta no seu país.

Collector and Application cannot be from different countriesUm aplicativo que não corresponde ao site do coletor está sendo usado.

card_token_id is requiredSe a assinatura for criada com um modelo associado, o ID do token do cartão é necessário.

payer_email is requiredO e-mail do pagador é obrigatório.

Invalid value for payer_email, must be a valid email addressO email do pagador é inválido.

Invalid value for transaction amount, must be a positive numberO valor da assinatura é inválido, deve ser um número positivo.

Invalid value for transaction amount, only two decimals are allowedO valor da assinatura é inválido, apenas 2 casas decimais são permitidas.

Cannot pay an amount lower than ${currency_id} ${min amount}O valor da assinatura é inválido, o limite para o país é menor.

Cannot pay an amount greater than ${currency_id} ${max amount}O valor da assinatura é inválido, o limite para o país é maior.

The transaction_amount must be the same as preapproval_planO valor da assinatura e o plano associado devem ser os mesmos.

You cannot create a new preapproval from a cancelled/inactive templateO plano ou modelo associado deve estar ativo.

back_url is requiredO url de retorno é obrigatório.

Invalid value for back url, must be a valid URLO url de retorno é inválido, deve ser um url válido.

reason is requiredO título da assinatura é obrigatório.

reason has more than 255 charactersO título da assinatura deve conter até 255 caracteres.

reason has unsupported charactersO título da assinatura contém caracteres inválidos.

auto_recurring.frequency is requiredA frequência é necessária.

Invalid value for frequency, must be a positive integerA frequência deve ser um valor positivo.

Invalid value for frequency type, valid ones are [days, months]O tipo de frequência deve ser dias ou meses.

auto_recurring.frequency_type is requiredO tipo de frequência é obrigatório.

auto_recurring.transaction_amount is requiredO valor da assinatura é necessário.

auto_recurring.currency_id is requiredO identificador de moeda é obrigatório.

Invalid field -> auto_recurring.currency_idO identificador da moeda é inválido.

Invalid value for auto_recurring.end_date, the date must be after todayA data de término da assinatura deve ser posterior à data atual.

auto_recurring.end_date must be after auto_recurring.start_dateA data de término da assinatura não pode ser inferior à data de início.

Invalid value for auto_recurring.start_date, the date must be after todayA data de início não pode ser posterior à data atual.

Invalid format in auto_recurring.start_date or auto_recurring.end_dateAs datas devem estar em um formato válido.

external_reference has more than 255 charactersA referência externa deve conter até 255 caracteres.

external_reference has unsupported charactersA referência externa contém caracteres inválidos.

Already exists a preapproval for user ${payer_email} and application ${application_id}Não pode haver mais de uma assinatura para o mesmo pagador, você deve cancelar a anterior.

Cannot operate between different countriesO pagador e o vendedor devem pertencer ao mesmo site.

Payer and collector cannot be the same userO pagador e o vendedor devem ser usuários diferentes.

Both payer and collector must be real or test usersNão é possível combinar usuários reais com usuários de teste.

This preapproval cannot be created: The seller does not accept account_moneyO meio de pagamento em dinheiro na conta não é suportado pelo vendedor.

This preapproval cannot be created only with payment method account_moneyVocê não pode criar uma assinatura com apenas dinheiro na conta.

You cannot create a preapproval with payment_method in status pendingUma assinatura criada pelo cliente não pode ter um meio de pagamento associado.

Cannot create preapproval pending, the feature with account money is disabled for your country.Você não pode criar assinaturas pendentes no momento em seu país.

Invalid request dataDetalhes de assinatura inválidos.

401bad_request

CC_VAL_433Método de pagamento rejeitado, você deve usar outro método de pagamento.

Verification of collectors personal data is in process, come back laterO vendedor está sendo analisado pela KYC.

Unauthorized access to resourceToken de acesso não enviado ou expirado.

This app cannot create preapprovals without a planA pré-aprovação deve ter recorrência automática.

403bad_request

The collector does not meet the personal data verification requirementsO vendedor não realizou as validações KYC.

The caller is not authorized to access this resourceUma pré-aprovação está sendo usada e não pertence a esse vendedor.

AM_VAL_01 Unauthorized seller for this featureO cobrador deve estar na whitelist para utilizar o meio de pagamento dinheiro na conta.

404bad_request

The preapproval with id ${preapproval id} does not existA assinatura com id $ {id} não existe.

Card token service not foundVocê está usando um token de cartão que não existe.