Home
Documentation
Resources
Certifications
Community

Resources

Check for updates on our solutions and system performance, or request technical support.

Community

Get the latest news, ask others for help and share your knowledge.

Considerations about Colombia's IVA - Checkout API - Mercado Pago Developers

Intelligent search powered by OpenAI 

Considerations about Colombia's IVA

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

Some products as well as some services are excluded from IVA and others have reduced rates. Currently, the general rate of this tax is 19%.

Taxes on online payments

In order to process your IVA tax correctly, we allow you to sent the total amount (transaction_amount), the net amount (net_amount) and IVA tax (taxes) when you receive a payment through API integration.

In this example we show you how to send the data:

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 '{
                "transaction_amount": 10000,
                "net_amount": 9500,
                "taxes":[{
                        "value": 500,
                        "type": "IVA"
                }],
                "token": "ff8080814c11e237014c1ff593b57b4d",
                "description": "Title of what you are paying for",
                "installments": 1,
                "payment_method_id": "visa",
                "payer": {
                        "email": "test_user_19653727@testuser.com"
                }
            }'

The IVA must be a certain amount, do not send a percentage. In case you do not send the net_amount and taxes attributes, the general IVA rate (19%) will be applied.

Taxes on in person payments

If you are integrating in person payments, you must inform the total amount of IVA to be paid on the total value of all the products listed in the item list.

curl

curl -X PUT \
    'https://api.mercadopago.com/instore/qr/seller/collectors/{user_id}/stores/{external_store_id}/pos/{external_pos_id}/orders' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{
  "external_reference": 12345,
  "title": "Product order",
  "notification_url": "www.yourserver.com",
  "total_amount": 6000,
  "items": [
    {
      "sku_number": "A123K9191938",
      "category": "marketplace",
      "title": "Item 1",
      "description": "Item",
      "unit_price": 3000,
      "quantity": 2,
      "unit_measure": "unit",
      "total_amount": 6000
    }
  ],
  "taxes": [
    {
      "value": 1140,
      "type": "IVA"
    }
  ],
  "sponsor": {
    "id": 446566691
  }
}'

If you do not send the tax attributes, the general IVA (19%) will be applied on the total value of the order.