Recursos para IA
Crear promesa de descuento

Este endpoint crea una promesa de descuento (con o sin cupón) para Wallet Connect. Una promesa de descuento es una referencia que puede utilizarse para aplicar un descuento específico a un pago ("advanced_payment"). Si es una promesa de descuento con cupón, este deberá ser previamente validado a partir del endpoint de "/v2/wallet_connect/coupons". La información de la promesa de descuento deberá incluirse durante la creación del pago, solicitada a partir del endpoint "/v1/advanced_payments". En caso de éxito, la solicitud devolverá una respuesta con el estado 200.

POST

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

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
x-payer-token
string

REQUERIDO

Token de pago asociado al comprador que utilizará el descuento.
Body
coupon
string
Código único del cupón para el descuento. Enviar solo cuando el comprador haya ingresado un cupón durante el flujo de compra.
amount
number

REQUERIDO

Monto total del pago antes de aplicar el descuento.
Response parameters
transaction_amount
number
Monto total del pago antes de aplicar el descuento.
currency_id
string
Moneda utilizada en el pago.
legal_terms
string
URL con los términos y condiciones del descuento.
discount
object
Detalles del descuento.
Errores

400Error de solicitud.

invalid_amount

El campo amount es inválido. Por favor, verifica el valor enviado e inténtalo nuevamente.

invalid_coupon

El ID del cupón es inválido. Por favor, verifica el valor enviado e inténtalo nuevamente.

invalid_payer_token

El token de pago enviado en el header "x-payer-token" es inválido. Por favor, verifica el valor enviado e inténtalo nuevamente.

500Error genérico.

internal_error

Ocurrió un error interno en el servidor. Intenta nuevamente más tarde. Si el problema persiste, contacta al soporte y proporciona el x-request-id y detalles sobre la operación realizada.

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