Recursos para IA
Criar promessa de descontohttps://api.mercadopago.com/v2/wallet_connect/discounts
Este endpoint cria uma promessa de desconto para o Wallet Connect. Uma promessa de desconto é uma referência que pode ser usada ao criar um advanced payment para aplicar um desconto específico. As informações da promessa de desconto devem ser incluídas durante a criação do pagamento. Em caso de sucesso, a requisição retornará uma resposta com o status 200.
POST
Request parameters
Header
Authorization
Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.string
OBRIGATÓRIO
x-payer-token
Token de pagamento associado ao comprador que utilizará o desconto.string
OBRIGATÓRIO
Body
coupon
Código único do cupom para o desconto. Envie somente quando o comprador tiver inserido um cupom durante o fluxo de compra.string
amount
Valor total do pagamento antes da aplicação do desconto.number
OBRIGATÓRIO
Response parameters
transaction_amount
Valor total do pagamento antes da aplicação do desconto.number
currency_id
Moeda utilizada no pagamento.string
legal_terms
URL com os termos e condições do desconto.string
discount
Detalhes do desconto.object
Erros
400Erro de requisição.
400
Bad Request — Valor inválido.
400
Bad Request — Cupom inválido.
400
Bad Request — Payer token inválido.
500Erro de processamento.
internal_error
Ocorreu um erro do nosso lado ao tentar processar a requisição. Por favor, tente novamente mais tarde.
Request
curl -X POST \
'https://api.mercadopago.com/v2/wallet_connect/discounts'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
-H 'x-payer-token: <PAYER_TOKEN>' \
-d '{
"coupon": "WALLET10",
"amount": 50
}'Response
{
"transaction_amount": "24.50",
"currency_id": "MXN",
"legal_terms": "https://api.mercadopago.com/v2/discounts/campaign/10580513/terms/html",
"discount": {
"amount": "24.50",
"detail": {
"cap": 1000000,
"type": "percentage",
"value": 10
}
}
}