Skip to content

Payment Processor Microservice ​

INFO

If you only want to use TiruPay, this section is not relevant for you. The Payment Processor Microservice is used internally by TiruPay to handle payments, but if you're using TiruPay, you don't need to interact with it directly.

The Payment Processor Microservice is a dedicated service that handles payment processing for various payment providers. It is designed to be modular and extensible, allowing for easy integration of new payment providers as needed. It's used by TiruPay but can be used by any service interested in integrating payments using a unified payment logic.

Supported Payment Providers ​

Features ​

  • Seamless integration with multiple payment providers.
  • Unified API for processing payments.
  • Support for webhooks to handle payment status updates.
  • Secure handling of payment data.
  • Partner OAuth Logic to integrate Mollie/Stripe Connect and collect payments in the name of a customer.
  • API Logs keep track of all requests coming in, and all responses.
  • User management / Service API keys keep content and features secure for those who need access.

Getting Started ​

After setting up the TiruPay Payment Processor, you can start integrating payment providers by following the specific documentation for each provider.

The process for all partners is similar, with slight variations based on the provider's API and requirements and the available payment methods.

The idea:

Payment Flow ​

  1. Create / Update Customer Create or update a customer in TiruPay Payment Provider.
  2. This will create or update the customer in the respective payment provider (Mollie / Stripe).
  3. Create Payment: Create a payment object with the details you already know. This payment object is only stored on TiruPay Payment Processor for now.
  4. Select Payment: Once you select the payment, providing the details necessary (depending on the checkout mode and partner), TiruPay Payment Processor will create the payment in the respective payment provider (Mollie / Stripe) and return the payment URL or client secret to complete the payment.
  5. Redirect User: Redirect the user to the payment URL (Mollie) or use the client secret to complete the payment (Stripe).
  6. Wait for redirect: After the user completes the payment, they will be redirected back to your specified return URL. The TiruPay Payment Processor will already know the updated status.
  7. Handle Webhooks: The TiruPay Payment Processor will send webhook notifications to your specified webhook URL to inform you about payment status updates AND you can always fetch the current state of a payment via the API.

What the payment processor does NOT offer ​

The payment is only meant to keep track of payments, it does not contain any logic for:

  • articles
  • orders / subscriptions logic (like upgrades, downgrades, cancellations)
  • invoices
  • dunnings
  • context based retries of payments
  • balances
  • collected taxes
  • any email notifications

If you need this logic, you can use TiruPay or integrate the logic on your own surrounding our payment processor.