Estamos evolucionando nuestra forma de integrar. Descubre la nueva API Orders

Recursos para IA

Consideraciones sobre el IVA en Colombia

El IVA (Impuesto al Valor Agregado) es una carga fiscal que recae sobre la venta de productos o la prestación de servicios dentro del territorio colombiano.

Algunos productos y servicios están excluidos del IVA y otros tienen tarifas reducidas. En la actualidad, la tarifa general de este impuesto es del 19%.

Impuestos en pagos online

Para procesar el IVA correctamente, puedes enviar el monto neto (unit_price) e IVA (taxes) al momento de realizar el cobro a través de la API.

El parámetro taxes.value debe completarse únicamente con un valor numérico entero. Nunca envíes el símbolo de porcentaje o caracteres especiales.

A continuación te mostramos cómo enviar los datos:

CampoTipoDescripciónObservaciones
itemsArrayLista de productos o servicios a cobrar-
items.titleStringTítulo del producto o servicio-
items.quantityIntegerCantidad de unidades-
items.unit_priceFloatPrecio unitario del producto sin IVA-
items.currency_idStringIdentificador de la moneda (COP para Colombia)-
taxesArrayLista de impuestos aplicablesSi no se envía ningún valor, se considera por defecto que debe aplicarse una reducción del 19% sobre el monto total de la transacción, correspondiente al IVA general.
taxes.typeStringTipo de impuesto (IVA)-
taxes.valueIntegerMonto del impuesto en valores absolutosDebe ser un monto entero, no acepta decimales o caracteres especiales. Para productos exentos de IVA, asígnale un valor de 0.

curl

curl -X POST \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  'https://api.mercadopago.com/v1/payments' \
  -d '{
    "items": [
      {
        "title": "Title of what you are paying for",
        "quantity": 1,
        "unit_price": 10000,
        "currency_id": "COP"
      }
    ],
    "taxes": [
      {
        "type": "IVA",
        "value": 500
      }
    ],
    "payer": {
      "email": "test_user_co@testuser.com"
    },
    "back_urls": {
      "success": "https://www.tu-sitio.com/success",
      "failure": "https://www.tu-sitio.com/failure",
      "pending": "https://www.tu-sitio.com/pending"
    },
    "auto_return": "approved"
  }'
No utilices dominios locales en el valor back_urls, tales como 'localhost/' o '127.0.0.1' con o sin puerto especificado. Recomendamos usar un servidor con dominio nombrado (DNS) o IPs de desarrollo para poder regresar al sitio después del pago. De lo contrario, aparecerá el mensaje de "Algo ha salido mal" al finalizar el proceso de compra.