paysuper-tax-service

README

PaySuper Tax Service

PaySuper performs like a tax agent for its customers. PaySuper Tax Service determines tax rates for different regions.

Tax legislation in different regions is quite complex. For example, the EU rules require at least two unambiguous factors in determining the tax rate, Russia requires to pay taxes if the BIN card is issued in Russia, in the US taxes vary not only of the state and city, but even, in some cases, depending on the street names in the same city.

---

Features

• Determining the VAT rate for a specified user's region.
• Using a user's provided information and autodetecting information by a user's IP address.

Table of Contents

• How it works
• Usage
• Contributing
• License

How it works

PaySuper Tax uses two types of information from a request:

• information provided by a user himself - this data has the highest priority in determining the taxes.
• information received by a user's IP address - this data is used if information provided by user is not enough or for some reason, we cannot get the tax rates from that.

Additional factors such as the user's language, time zone location and other criteria must be calculated before requesting this service.

Usage

Application can be launched with Kubernetes and handles all configuration from the environment variables:

Variable	Description
TAX_SERVICE_DSN	Postgress DSN string
TAX_SERVICE_METRICS_PORT	Http port to expose /health endpoint. Default is 8080.
TAX_SERVICE_KUBERNETES_SERVICE_HOST	Should be true to launch in k8 mode. Default is false.

Contributing, Feature Requests and Support

If you like this project then you can put a ⭐️ on it. It means a lot to us.

If you have an idea of how to improve PaySuper (or any of the product parts) or have general feedback, you're welcome to submit a feature request.

Chances are, you like what we have already but you may require a custom integration, a special license or something else big and specific to your needs. We're generally open to such conversations.

If you have a question and can't find the answer yourself, you can raise an issue and describe what exactly you're trying to do. We'll do our best to reply in a meaningful time.

We feel that a welcoming community is important and we ask that you follow PaySuper's Open Source Code of Conduct in all interactions with the community.

PaySuper welcomes contributions from anyone and everyone. Please refer to our contribution guide to learn more.

License

The project is available as open source under the terms of the GPL v3 License.