The Amount Object
| Parameter | Type | Description | Values /Default |
|---|---|---|---|
currency | string | Required. The currency of the transaction | COP |
iva | number | Required. Value added Tax (VAT). Send it in 0 in case the transaction does not include this tax | |
subtotal_iva | number | Required. Net amount of a transaction where iva or any other tax applies. (iva, ica, etc.) but not including the amount of the tip (if applicable). In case the transaction does not have any tax, set this parameter to 0 and send the subtotal in the subtotal_iva0 field | |
subtotal_iva0 | number | Required. Send in this field the subtotal of the transaction if the transaction does not have any tax included. Don't include the amount of the tip (if applicable). In case the transaction does have taxes, set this parameter to 0 and send the subtotal in the subtotal_iva field | |
tip | number | Optional. The amount of the tip. Skip this field in case you don't want to include a tip. | |
extra_taxes | object | Optional. Additional taxes | |
airport_tax | number | Optional. Airport tax | |
travel_agency | number | Optional. Used in airlines | |
iac | number | Optional. Industry and Trade Tax | |
ice | number | Optional. Special Consumption Tax |
Examples
Transaction where IVA (VAT) applies
iva = 19000 COP
Total with iva= 119000 COP
"amount": {
"currency": "COP",
"iva": 19000,
"subtotal_iva": 100000,
"subtotal_iva0": 0
},IVA (VAT) exempt transaction
iva = 0 COP
Total with iva= 100000 COP
"amount": {
"currency": "COP",
"iva": 0,
"subtotal_iva": 0,
"subtotal_iva0": 100000
},Transaction where IVA (VAT) and tip applies
iva = 19000 COP
tip = 10000
Total with iva= 119000 COP
Total amount of the transaction (with iva and tip included)= 129000 COP
"amount": {
"iva": 19000,
"tip": 10000,
"currency": "COP",
"subtotal_iva": 119000,
"subtotal_iva0": 0
},Modified at 2026-09-05 00:18:23