Nimara Stripe

Integration between Stripe and Saleor for payment processing and tax calculations.

Features

• Payment Processing: Seamless integration with Stripe Payment Intents
• Multi-channel Support: Configure different Stripe accounts for each Saleor channel
• Tax Calculation: Automated tax calculations using Stripe Tax
• Webhook Support: Full support for Stripe webhooks to handle payment status updates
• Fully Typed: Complete type checking with MyPy for better code reliability

Requirements

Development

• Python 3.12+
• UV package manager
• Docker and Docker Compose
• Localstack (for local AWS services)
• Stripe account

Production

• AWS Account with appropriate IAM permissions
• OpenTofu (or Terraform) for infrastructure management
• Stripe account with API keys configured

Local Development

1. Clone the repository

git clone https://github.com/mirumee/nimara-stripe.git
cd nimara-stripe

2. Set up environment

Copy the example environment file and update it with your specific values:

cp .env.example .env

3. Start the application

Using Docker Compose:

docker compose run --rm -P app

The application will be exposed on port 8080 by default.

Configuration

App installation

1. Deploy the app to your environment
2. Install the app in your Saleor instance
3. Set up a webhook in Stripe:
   • URL: https://<YOUR_DOMAIN>/payment/webhook
   • Listen for payment_intent.* events

Saleor Configuration

Open the app dashboard in Saleor and configure:

• Stripe public key
• Stripe secret key
• Stripe webhook secret key

Configure these settings for each channel you want to use with Stripe.

Development

Running tests

make test

Code quality checks

make check

Building Lambda packages

make all

Deployment

Please check out our Deployment Guide for more details.

Contributing

Contributions are welcome! Please check out our Contributing Guide for more details.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Run make check to ensure all tests and linting pass
4. Commit your changes (git commit -m 'Add some amazing feature')
5. Push to the branch (git push origin feature/amazing-feature)
6. Open a Pull Request

License

This project is licensed under the BSD 3-Clause License - see the LICENSE file for details.

Acknowledgments

• Saleor - The e-commerce platform
• Stripe - Online payment processing for internet businesses

---

❤️ Community & Contribution

Join Nimara community on GitHub Discussions and Discord server. You can ask questions, report bugs, participate in discussions, share ideas or make feature requests.

You can also contribute to Nimara in various ways:

• Report issues and suggest new features.
• Review documentation and submit pull requests—whether it's fixing typos or adding new features.
• Share your experiences or projects related to Nimara with the broader community through talks or blog posts.
• Support popular feature requests by upvoting them.

Crafted with ❤️ by Mirumee Software

hello@mirumee.com