Inicio
Documentação
Recursos
Parcerias
Comunidade

Recursos

Confira as atualizações das nossas soluções e do funcionamento do sistema ou peça suporte técnico.

Parcerias

Conheça nosso programa para agências ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratá-los.

Comunidade

Fique por dentro das últimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Criar promessa de desconto - Descontos - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Criar promessa de desconto

POST

https://api.mercadopago.com/v2/wallet_connect/discounts
Este endpoint permite criar uma "promesa de descuento" para o Wallet Connect. Essa "promesa de descuento" é uma referência que será usada ao gerar um Advanced Payment, possibilitando aplicar um desconto específico ao pagamento. Durante a criação do pagamento, é essencial incluir as informações da "promesa de descuento" fornecida anteriormente.
Parâmetros de requisição
HEADER
x-payer-token
string

OBRIGATÓRIO

Token relacionado ao potencial pagador que utilizará o desconto. Por exemplo - e9449535fe074e0e8ff4f2055f604e51.
BODY
coupon
string
ID único que identifica o cupom para aplicação do desconto. Este campo deve ser preenchido somente quando o usuário inserir um cupom durante o processo de compra junto ao vendedor.
amount
number

OBRIGATÓRIO

Valor total do pagamento antes da aplicação do desconto. Por exemplo, 15.05.
Parâmetros de resposta
transaction_amount
number
Valor total do pagamento antes da aplicação do desconto. Por exemplo, 150.
currency_id
string
Tipo de moeda a ser utilizada no pagamento. Por exemplo, ARS, para Argentina, BRL, para Brasil. Este campo varia de acordo com sua localidade.
legal_terms
string
Termos e condições do desconto.
discount
object
Descrição do desconto.
Erros

400Erro

400

Bad-Request - Valor de desconto inválido.

400

Bad-Request - Cupom de desconto inválido.

400

Bad-Request - Payer token inválido.

500Erro

500

Erro - Erro interno do servidor.

Requisição
curl -X POST \
    'https://api.mercadopago.com/v2/wallet_connect/discounts'\
    -H 'Content-Type: application/json' \
       -H 'x-payer-token: <PAYER_TOKEN>' \
       -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
    -d '{
  "coupon": "WALLET10",
  "amount": 15.05
}'
Resposta de exemplo
{
  "transaction_amount": 150,
  "currency_id": "ARS",
  "legal_terms": "https://api.mercadopago.com/v2/discounts/campaign/10580513/terms/html",
  "discount": {
    "amount": 15,
    "detail": {
      "cap": 1000000,
      "type": "percentage",
      "value": 10
    }
  }
}