[$2000] Build a CommerceTools Plugin for Hyperswitch #6008

Read this wiki to know how to Participate

Please make sure to read this through the below Guidelines before attempting the problem statements

Contribution Guidelines
Bounty Program Guidelines
Terms of Contest

Introduction

We are an open-source, high-performance payment switch designed to unify the growing diversity of payment methods. It acts as a universal adaptor, connecting various payment processors, networks, banks, and wallets. By integrating Hyperswitch with commercetools, we aim to provide merchants with a flexible and cost-effective payment solution that enhances user experience and improves conversion rates.

We are looking for contributors who can help us build plugins that integrate Hyperswitch with commercetools to enable seamless payment processing for e-commerce platforms built on commercetools.

Objectives:

• Create a commercetools extension that connects to Hyperswitch's API.
• Enable merchants to process payments through various payment providers supported by Hyperswitch.
• Implement necessary payment flows (authorization, capture, refund, etc.).
• Ensure proper error handling and logging.
• Provide seamless integration with commercetools' existing payment infrastructure.

Requirements:

• The extension should be developed following commercetools' best practices and guidelines.
• Utilize Hyperswitch's API documentation for integration.
• Implement necessary security measures for handling sensitive payment data.
• Ensure compatibility with the latest versions of commercetools and Hyperswitch.
• Implement Proxy support for any outgoing API requests.
• Support multi-tenancy to serve multiple commercetools projects with one application instance.

Deliverables:

• A functional commercetools extension for Hyperswitch integration.
• Comprehensive documentation including:
  • Installation instructions.
  • Configuration guide.
  • Usage examples.
  • Troubleshooting section.
• Unit and integration tests.

Sample implementation for Reference

WooCommerce Plugin

Implementation Details:

1. Extension Module:

   • Implement as a commercetools HTTP API Extension.
   • Process payment creation and update requests from commercetools.
   • Communicate with the Hyperswitch API to initiate payments, captures, refunds, etc.
   • Map Hyperswitch responses to commercetools payment objects.
   • Handle error scenarios and provide appropriate responses.

2. Notification Module:

   • Create a publicly exposed service to receive webhooks from Hyperswitch.
   • Process incoming notifications and update corresponding payments in commercetools.
   • Implement retry mechanisms for failed updates.
   • Ensure idempotency to handle duplicate notifications.

Resources:

• commercetools HTTP API Extensions Guide:https://docs.commercetools.com/api/projects/api-extensions
• commercetools Payments API: https://docs.commercetools.com/api/projects/payments
• Hyperswitch API Documentation: https://api-reference.hyperswitch.io/api-reference/payments/payments--create
• commercetools GitHub Repository: https://github.com/commercetools
• Hyperswitch GitHub Repository: https://github.com/juspay/hyperswitch

Flow Diagram: