Tpay
Платёжный провайдер tpay для Medusa
Medusa tpay Payment Provider
MedusaJS | Tpay Homepage | Tpay Docs | npm
Compatibility
This plugin is compatible with Medusa v2.4.0+.
Overview
This plugin provides Tpay payment integration for Medusa commerce platform.
Installation
Configuration
Add the payment provider configuration to your :
Usage
Overview
Once configured, Tpay will be available as a payment provider in your Medusa store. The plugin integrates seamlessly with Medusa's payment workflow to handle the complete payment lifecycle.
Required Data
The following data is required from your checkout flow and needs to be provided in the call in order to create a tpay transaction:
Payment Flow
When a customer selects Tpay as their payment method during checkout, the plugin creates a new transaction with Tpay and returns a payment URL.
-
Redirect: Redirect the customer to the provided Tpay payment URL to let them complete the payment on tpay's pay-by-link page.
-
Payment Processing: After completing or canceling the payment, the customer is redirected back to your store via the configured values.
-
Webhook Notification: Tpay sends a webhook notification to your configured endpoint to confirm the payment status. The plugin automatically validates and processes these webhooks.
-
Order Completion: Based on the webhook data, Medusa updates the payment and order status accordingly.
Webhook Configuration
The webhook endpoint is automatically registered at . Ensure that:
- Your points to this endpoint (e.g., )
- The endpoint is publicly accessible
- Your firewall allows incoming requests from tpay's servers
Refunds
Refunds can be processed through Medusa's admin panel or API. The plugin will:
- Create a refund request with Tpay Process partial or full refunds
- Update the order status in Medusa accordingly
You can customize the refund description using the option in the plugin configuration.