AI resources

VAT considerations in Colombia

VAT (Value Added Tax) is a tax burden that applies to the sale of products or the provision of services within Colombian territory.

Some products and services are excluded from VAT and others have reduced rates. Currently, the general rate for this tax is 19%.

Taxes in online payments

To process VAT correctly, you can send the net amount (unit_price) and VAT (taxes) when creating the order through the Create orderAPI endpoint.

The taxes.value parameter must be sent as a string representing an integer amount. Do not send the percent symbol, decimals, or special characters.
FieldTypeDescriptionRemarks
itemsArrayList of products or services to charge-
items.titleStringTitle of the product or service-
items.quantityIntegerNumber of units-
items.unit_priceStringUnit price of the product without VAT-
taxesArrayList of applicable taxesIf no value is sent, a 19% reduction on the total transaction amount will be applied by default, corresponding to the general VAT.
taxes.typeStringTax type (IVA)-
taxes.valueStringTax amount in absolute valuesMust be sent as a string representing an integer amount. For VAT-exempt products, set it to "0".
The order total_amount is always the sum of items[].unit_price × items[].quantity and does not include taxes[].value. For example, if the product price is 10,000 COP and the VAT is 500 COP, the total_amount remains 10,000 COP; report VAT separately in the taxes array.
curl
curl -X POST \
    -H 'accept: application/json' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer ENV_ACCESS_TOKEN' \
    -H 'X-Idempotency-Key: UNIQUE_KEY' \
    'https://api.mercadopago.com/v1/orders' \
    -d '{
  "type": "online",
  "processing_mode": "manual",
  "total_amount": "10000",
  "external_reference": "order_pro_123",
  "payer": {
    "email": "test_payer@example.com"
  },
  "items": [
    {
      "title": "My product",
      "unit_price": "10000",
      "quantity": 1
    }
  ],
  "taxes": [
    {
      "type": "IVA",
      "value": "500"
    }
  ]
}'