Recursos para IA
Criar promessa de desconto

Este endpoint cria uma promessa de desconto (com ou sem cupom) para o Wallet Connect. Uma promessa de desconto é uma referência que pode ser usada para aplicar um desconto específico a um pagamento ("advanced_payment"). Caso seja uma promessa de desconto com cupom, este deverá ser previamente validado a partir do endpoint de "/v2/wallet_connect/coupons". As informações da promessa de desconto deverão ser incluídas durante a criação do pagamento, solicitada a partir do endpoint "/v1/advanced_payments". Em caso de sucesso, a requisição retornará uma resposta com o status 200.

POST

https://api.mercadopago.com/v2/wallet_connect/discounts
Request parameters
Header
Authorization
string

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
x-payer-token
string

OBRIGATÓRIO

Token de pagamento associado ao comprador que utilizará o desconto.
Body
coupon
string
Código único do cupom para o desconto. Envie somente quando o comprador tiver inserido um cupom durante o fluxo de compra.
amount
number

OBRIGATÓRIO

Valor total do pagamento antes da aplicação do desconto.
Response parameters
transaction_amount
number
Valor total do pagamento antes da aplicação do desconto.
currency_id
string
Moeda utilizada no pagamento.
legal_terms
string
URL com os termos e condições do desconto.
discount
object
Detalhes do desconto.
Erros

400Erro de requisição.

invalid_amount

O campo amount é inválido. Por favor, verifique o valor enviado e tente novamente.

invalid_coupon

O ID do cupom é inválido. Por favor, verifique o valor enviado e tente novamente.

invalid_payer_token

O token de pagamento enviado no header "x-payer-token" é inválido. Por favor, verifique o valor enviado e tente novamente.

500Erro genérico.

internal_error

Ocorreu um erro interno no servidor. Tente novamente mais tarde. Se o problema persistir, entre em contato com o suporte e forneça o x-request-id e detalhes sobre a operação realizada.

Request
curl -X POST \
    'https://api.mercadopago.com/v2/wallet_connect/discounts'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-5*********956537-12*********ff1a3d36d*********47e7b9985*********770' \
       -H 'x-payer-token: <PAYER_TOKEN>' \
    -d '{
  "coupon": "WALLET10",
  "amount": 50
}'
Response
{
  "transaction_amount": "24.50",
  "currency_id": "UYU",
  "legal_terms": "https://api.mercadopago.com/v2/discounts/campaign/10580513/terms/html",
  "discount": {
    "amount": "24.50",
    "detail": {
      "cap": 1000000,
      "type": "percentage",
      "value": 10
    }
  }
}