Teya Payments

Accept online card payments with Teya Hosted Checkout

Teya Payments lets merchants accept secure online card payments in Drupal Commerce using Teya Hosted Checkout. Customers choose Teya Payments during checkout, are redirected to Teya’s secure hosted payment page, complete payment, and return to the store after payment confirmation.

The module keeps card entry and payment authentication on Teya’s hosted checkout page, so card data is not collected or stored by the Drupal Commerce store.

Key Features

• Connect a Drupal Commerce store to a Teya merchant account through the Teya Business Portal registration flow.
• Supports separate test and live Teya environments.
• Provides a Drupal Commerce payment gateway integration for Teya Hosted Checkout.
• Creates Teya Hosted Checkout payment sessions from Drupal Commerce orders.
• Redirects customers to Teya for secure payment completion.
• Uses signed Teya payment webhooks to confirm successful payments.
• Updates Drupal Commerce payments and order state after successful payment confirmation.
• Supports full and partial refunds through Drupal Commerce when supported by the configured payment workflow.
• Stores the Teya transaction ID for refund and reconciliation workflows.
• Supports Teya Hosted Checkout language selection based on the Drupal site or checkout language.
• Supports optional merchant and customer success receipt emails through Teya.
• Includes configurable payment method title and description.
• Includes debug logging for troubleshooting integration issues.
• Supports disconnecting the Teya merchant account from the Drupal administration interface.

Payment Flow

When a customer places an order using Teya Payments, Drupal Commerce creates the order and the module requests a Hosted Checkout session from Teya. The customer is redirected to Teya to complete payment. After a successful payment, Teya sends a signed webhook to the Drupal Commerce store. The module verifies the webhook, validates the related order and payment data, updates the Drupal Commerce payment, and advances the order according to the configured Commerce workflow.

Refunds

Merchants can process full and partial refunds through Drupal Commerce where supported by the configured payment gateway workflow. The module sends the refund request to Teya using the original Teya payment transaction ID and updates the related Drupal Commerce payment information after the refund is processed.

Security

The module uses OAuth2 credentials received through Teya’s registration flow. Registration callbacks and payment webhooks are verified using RSA signatures. Credentials and access tokens are stored using Drupal configuration and state mechanisms as appropriate. The module does not collect or store cardholder data.