Procesar pagos con descuento

En esta sección, detallamos las solicitudes y los parámetros necesarios para procesar pagos con descuento, y las respuestas esperadas para cada una de ellas.

Importante

El reembolso del descuento no es instantáneo; puede tardar unos 200 milisegundos sin un cupón y hasta 10 segundos con un cupón. Por lo tanto, recomendamos crear la promesa de descuento y proceder inmediatamente con el pago.

Para realizar el procesamiento de los pagos con descuento, utiliza el curl a continuación y asegúrate de que los parámetros de la solicitud estén completos de acuerdo con la información descrita en la siguiente tabla.

Parámetro	Tipo	Descripción	Ejemplo
Authorization	String	Token de autorización del usuario (Access token). Esta información se puede obtener a través del menú Tus integraciones.	APP_USR-123456-test-access-t0ken
wallet_payment	Object	Objeto que agrupa información de pago procesado a través de Wallet Connect.	N/A
transaction_amount	Double	Valor por el cual se efectúa el pago.	550.0
description	String	Descripción genérica del pago que se está efectuando.	"Descripción del pago"
external_reference	String	Referencia de pago asignada por el vendedor. Solo acepta números y letras.	"Pagamento_123"
discount	Object	Campo opcional que agrupa los datos del descuento a aplicar. Este campo sólo es obligatorio si deseas crear un pago con descuento. Si se envía vacío, creará un pago sin descuento.	N/A
amount	Double	Valor del descuento a aplicar en el pago.	55.0
description	String	Descripción del descuento.	"Descuento para Black Friday".
detail	Object	Objeto que proporciona información sobre las características del descuento.	N/A
value	Double	Cantidad de descuento a aplicar en el pago. Este campo se corresponde con el `type` mencionado abajo, por ejemplo, 30 por ciento.	10.0
type	String	Unidad de medida del valor de descuento, pudiendo ser porcentual o un monto fijo.	percent (para porcentaje) o fixed (para valores fijos).
cap	Double	Valor máximo por el cual el descuento puede ser aplicado en un pago.	5000
payer	Object	Objeto que contiene los datos del pagador.	N/A
token	String	Token específico del pagador, utilizado para realizar toda la validación del flujo de pago.	payer1-token2-test3-example4
type_token	String	Tipo de token a ser utilizado en los pagos.	wallet-token (este es el único tipo de token aceptado para los pagos a través de Wallet Connect).

          
curl -X POST \
'https://api.mercadopago.com/v1/advanced_payments' \
--header 'Authorization: <YOUR_ACCESS_TOKEN>' \
--data '{
    "wallet_payment": {
        "transaction_amount": 550,
        "description": "Descripción del pago",
        "external_reference": "Pago_123",
        "discount": {
            "amount": 55.0,
            "description": "Pruebas wc",
            "detail": {
                "value": 10.0,
                "type": "percent",
                "cap": 5000
            }
        }
    },
    "payer": {
        "token": "PAYER_TOKEN",
        "type_token": "wallet-token"
    }
}'

Respuestas

A continuación detallamos las diferentes respuestas que pueden recibirse al procesar un pago con descuento. Las mismas se categorizan en base al resultado de la solicitud, variando desde el éxito en el procesamiento hasta un error específico.

Éxito

{
  "id": 1234567,
  "status": "approved",
  "marketplace": null,
  "sponsor_id": null,
  "payments": [
    {
      "id": "PAYMENT-ID",
      "status": "approved",
      "status_detail": "accredited",
      "payment_type_id": "account_money",
      "payment_method_id": "account_money",
      "token": null,
      "transaction_amount": 500,
      "installments": 1,
      "processing_mode": "aggregator",
      "issuer_id": null,
      "coupon_amount": 10.0,
      "campaign_id": "CAMPAIGN-ID",
      "coupon_code": null,
      "description": "Payment Wallet",
      "external_reference": null,
      "statement_descriptor": null,
      "date_of_expiration": null,
      "merchant_account_id": null,
      "payment_method_option_id": null,
      "additional_info": null,
      "transaction_details": null,
      "net_amount": null,
      "taxes": null
    }
  ],
  "disbursements": null,
  "payer": {
    "id": "PAYER-ID",
    "email": "PAYER-EMAIL",
    "address": null,
    "identification": null,
    "first_name": null,
    "last_name": null,
    "phone": null,
    "token": "PAYER-TOKEN",
    "external_payer_id": "EXTERNAL-PAYER-ID"
  },
  "external_reference": null,
  "description": null,
  "binary_mode": true,
  "capture": true,
  "date_created": "2023-07-24T14:30:45.574-04:00",
  "date_last_updated": "2023-07-24T14:30:46.517-04:00",
  "metadata": null,
  "additional_info": null,
  "wallet_payment": {
    "transaction_amount": 550,
    "description": "Payment Wallet",
    "external_reference": null,
    "subscription_data": null,
    "user_present": null,
    "discount": {
      "amount": 50.0,
      "description": "wallet connect test",
      "detail": {
        "value": 10.0,
        "type": "percent",
        "cap": 100000.0
      }
    },
    "payment_preference": {
      "active": true,
      "user_id": 1431302201,
      "payment_method": [
        {
          "priority": 1,
          "payment_method": "account_money"
        }
      ]
    }
  },
  "pos_id": null,
  "store_id": null,
  "wallet_connect_discount": {
    "amount": 10.0,
    "token": "DISCOUNT-TOKEN"
  }
}

Error

En caso de que el descuento aplicado en el pago no sea válido o el valor indicado en el pedido no corresponda al valor del descuento establecido, se generará un error, como se describe a continuación.

{
  "error": "bad_request",
  "message": "discount doesn't exist or amount is incorrect",
  "status": 400,
  "cause": [
    {
      "code": 400136,
      "description": "discount doesn't exist or amount is incorrect",
      "data": null
    }
  ]
}

Responses

Learn about the different responses that can be received when creating a discount promise without a pre-added coupon.

Payment flow

Get to know Advanced Payments and learn how to make payments flow through our APIs.