Lets you add transactions with a different currency using the currency conversion ratio. The following are the prerequisites or checklists for the API.

Important

All monetary fields in transaction line items (such as amount, rate, value, and discount) are rounded based on the AMOUNT_ROUNDING_OFF_TO_DECIMAL_PLACES configuration. If this configuration is set to a value greater than or equal to 0, the system rounds all monetary fields to the specified number of decimal places using rounding down. For example, a value of 38.98 may become 38.97 if the configuration is set to 2 decimal places.

To ensure correct storage and retrieval of decimal values in transaction APIs, set AMOUNT_ROUNDING_OFF_TO_DECIMAL_PLACES to one more than the value of CONF_DECIMAL_PLACES_FOR_BASE_CURRENCY. For example, if CONF_DECIMAL_PLACES_FOR_BASE_CURRENCY is set to 2, set AMOUNT_ROUNDING_OFF_TO_DECIMAL_PLACES to 3.

📘

Notes

• Enable CONF_CURRENCY_CONVERSION_ENABLE on the Billing Configuration page of InTouch Profile > Organization Settings > Systems & Deployment > InTouch POS Configurations>Billing.
• Configure org’s base currency and supported currencies on the Organization Setup page of InTouch Profile > Organization Settings > Organization Setup > Organization Profile.
• If no currency code is provided, the system will use the store's default currency.
• All monetary values should be provided in the local currency format.
• The API automatically handles conversion between local and base currency.
• The response includes both local and base currency values for all monetary fields.
• Add relevant currency conversion ratios in the back-end either through /v2/currencyratio API or through Data Import.
• The issual of points/coupon or redemption is calculated automatically as per the destination currency.
• Negative values for transaction values such as amount, discount are not considered.

Example request

curl --location 'https://eu.api.capillarytech.com/v1.1/transaction/add_with_local_currency?format=json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic dGpfY2FwaWxsYXJ5OjVjMTc3MDJlOTI5NjQ4MjUzZTY3ZDJiMGM2ZTk5ZjE5' \
--header 'Cookie: _cfuvid=vExzxUfM1yVs0RkX2QTpuwcO53_TtBBvj4IQ3.2hA38-1739337355889-0.0.1.1-604800000; _cfuvid=TSCGvpdRkTXfEHaK7wh4GeeIIboDUZw.MFvq2rh0bhE-1739505014810-0.0.1.1-604800000; _cfuvid=Fa2ZZlikT6UXCljFwOpFWmmpr_ln0Nfz0KVEXjICAXM-1744170473439-0.0.1.1-604800000' \
--data-raw '{
    "root": {
        "transaction": [
            {
                "line_items": {
                    "line_item": [
                        {
                            "type": "Regular",
                            "serial": 1,
                            "value": 20,
                            "description": "Steel Bottle",
                            "item_code": "model_id_001",
                            "qty": 4,
                            "discount": 0,
                            "rate": 5,
                            "amount": 20,
                            "transaction_date": "2025-02-26 09:00:00",
                            "transaction_number": "test00transact064"
                        }    
                    ]
                },
                "type": "regular",
                "currency_code": "USD",
                "customer": {
                    "mobile": "919999988886",
                    "email": "[email protected]",
                    "firstname": "Tjuser",
                    "lastname": "Eightysix"
                },
                "credit_note": {
                    "amount": "60",
                    "notes": "Reason for credit",
                    "number": "test00transact064"
                },
                "number": "test00transact074",
                "amount": 60,
                "billing_time": "2025-04-08 17:30:00",
                "notes": "Transaction Number 74",
                "gross_amount": 60,
                "discount": 0
            }
        ]
    }
}'

Rate Limit

Request Body Parameters

customer object

credit_note object

Error Codes