Criar promessa de desconto com cupom pré-adicionado

A promessa de desconto com cupom pré-adicionado representa uma forma simplificada e eficiente de aplicar descontos em transações. Neste sistema, é possível que o vendedor exiba o preço com desconto de determinado produto antes de realizar o pagamento, ou seja, antes do checkout.

A criação da promessa de desconto com cupom pré-adicionado é feita em dois passos:

• Validar o cupom antes da realização do pagamento
• Adicionar o cupom antes de prosseguir para pagamento

Para validar um cupom antes de prosseguir com o pagamento, é importante enviar os dados da campanha na solicitação subsequente. Esta solicitação garante que o cliente possa aproveitar o benefício do desconto antes de finalizar a compra.

Para isso, utilize o curl abaixo e insira os parâmetros de acordo com a tabela descritiva. Esta solicitação verificará a validade do cupom e retornará informações detalhadas sobre o desconto aplicável, se houver.

          
curl -X POST \
'https://api.mercadopago.com/v2/wallet_connect/coupons' \
--header 'Authorization: <Bearer YOUR_ACCESS_TOKEN>' \
--header 'x-payer-token: <PAYER_TOKEN>' \
--header 'Content-Type: application/json' \
-d '{
    "id": "<COUPON>"
 }'

        

Quando a validação de um código de cupom é necessária durante o checkout, isto é, antes de efetuar o pagamento, é essencial enviar os dados da campanha na requisição subsequente.

Esta etapa envolve o envio de uma requisição ao sistema para aplicar o desconto do cupom à transação que está prestes a ser finalizada.

Utilize o curl abaixo para realizar a requisição e garanta que os parâmetros estejam preenchidos de acordo com a tabela descritiva a seguir.

          
curl -X POST \
  'https://api.mercadopago.com/v2/wallet_connect/discounts' \
  --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
  --header 'x-payer-token: <PAYER_TOKEN>' \
  --header 'Content-Type: application/json' \
  -d '{
      "amount": 550,
      "coupon": "<COUPON>"
  }'


        

Ao adicionar o cupom antes de prosseguir para o pagamento, é possível que diferentes respostas sejam recebidas (sucesso/erro). Veja abaixo o detalhamento de cada uma delas.

1. Resposta de sucesso ao adicionar cupom

• Código de status: nenhum código é devolvido nesta solicitação.

• Descrição: a resposta traz a informação referente à moeda, valor do desconto, termos legais, entre outros, o que atesta o sucesso da transação.

• Corpo da resposta:

  • json

  json

          
  {
    "transaction_amount": 550.0,
    "currency_id": "ARS",
    "discount": {
      "amount": 55.0,
      "detail": {
        "value": 10.0,
        "type": "percent",
        "cap": 1000.0
      },
     "legal_terms":"https://mp.com/legal"
    }
  }
  
  
        

  Copiar

1. Desconto inexistente para usuário

• Código de status: nenhum código é retornado.
• Descrição: Este erro retorna para informar que não existe um desconto disponível para o usuário.
• Corpo da resposta:

{
  "transaction_amount": 550.0,
  "currency_id": "ARS",
  "discount": {}
}

2. Transaction_amount deve ser maior que 0

• Código de status: 400 (Bad Request).

• Descrição: Este erro retorna quando o campo `transaction_amount_ é preenchido com valor 0. Neste caso, é necessário inserir um valor que seja superior a 0 e realizar uma nova requisição.

• Corpo da resposta:

  • json

  json

          
  {
    "error": "bad_request",
    "message": "transaction_amount must be greater than 0",
    "status": 400
  }
  
        

  Copiar

3. Transaction_amount não pode estar vazio

• Código de status: 400 (Bad Request).

• Descrição: Este erro retorna quando o campo `transaction_amount_ é deixado em branco. Neste caso, é necessário inserir um valor que seja superior a 0 e realizar uma nova requisição.

• Corpo da resposta:

  • json

  json

          
  {
    "error": "bad_request",
    "message": "transaction_amount must not be null.",
    "status": 400
  }
  
  
        

  Copiar