Solomono Instructions Connection of payment modules TRANZZO PAYMENT MODULE

TRANZZO PAYMENT MODULE

What You Will Configure

A Tranzzo Space account.
A check that the Credit cards module is enabled in Solomono.
The Tranzzo payment module in Payment Modules.
POS ID, API Key, Endpoints Key, and Secret Key in the Tranzzo module settings.
The default order status and the status after successful payment.
Callback URLs that must be available for automatic order status updates.

What You Need

Access to Tranzzo Space or an email address for registration.
An active Tranzzo project: test or production.
POS ID, API Key, Endpoints Key, and Secret Key from the same Tranzzo project.
Administrator access to the Solomono store.
Access to firewall, Cloudflare, or hosting settings if the website is protected by additional rules.

Warning. Tranzzo keys are confidential. Do not include them in screenshots, chats, or public instructions. They should be masked in documentation.

1. Register or Log In to Tranzzo Space

Open https://space.tranzzo.com/login?lang=en.
If you do not have an account yet, switch to Register and create one.
If the account already exists, use Log In and enter the email and password.
Complete reCAPTCHA or another security check if Tranzzo asks for it.

Figure 1. Tranzzo Space login and registration page

Warning. Tranzzo Space may show reCAPTCHA even when the password is correct. This is a normal security check and must be completed manually.

2. Find the Project Credentials in Tranzzo

Use credentials from one specific Tranzzo project. For live payments, use the production project. For testing, use the test project credentials.

Credential	Field in Solomono
POS ID	Tranzzo POS ID
API Key	Tranzzo API Key
Endpoints Key	Tranzzo Endpoints Key
Secret Key	Tranzzo Secret Key

Result. Tranzzo documentation describes API authentication with POS_ID, API_KEY/signature, and ENDPOINTS_KEY. The Solomono module provides separate fields for these values.

Figure 2. Tranzzo documentation: API authentication

3. Check That Credit Card Payments Are Enabled

Log in to the Solomono admin panel.
Open Modules → Solo modules.
Find the Credit cards module.
Make sure the switch is enabled.

Figure 3. Credit cards module enabled in Solo modules

4. Install or Open the Tranzzo Module

In the admin panel, open Modules → Payment.
Find Tranzzo in the Payment Modules list.
If you see a plus button next to Tranzzo, click it to install the module.
If the module is already installed, click the pencil icon to open its settings.

Figure 4. Tranzzo in the payment modules list

5. Fill In Tranzzo Settings in Solomono

Enable the Allow Tranzzo module switch.
Enter the Tranzzo POS ID.
Enter the Tranzzo API Key.
Enter the Tranzzo Endpoints Key.
Enter the Tranzzo Secret Key.
In Paid order status, select the status for a successfully paid order, for example Paid.
In Default order status, select the status assigned when the customer is redirected to payment, for example Awaiting for review.
Other fields are optional and can be changed later if needed.

Figure 5. Tranzzo module settings in Solomono

Warning. If you use Tranzzo test mode (XTS), enter keys from the Tranzzo test project. The Tranzzo checkout will use the XTS test currency.

Module Field Explanation

Field	Meaning
Allow Tranzzo module	Enables or disables Tranzzo as a payment method in the store.
Tranzzo POS ID	The POS/project identifier in Tranzzo.
Tranzzo API Key	API key used for request authentication/signing.
Tranzzo Endpoints Key	Key used when calling Tranzzo API endpoints.
Tranzzo Secret Key	Secret key used for signatures and secure callback processing.
Sort order	Display order among other payment methods.
Paid order status	Status assigned after successful payment.
Default order status	Initial order status before payment confirmation.
Zone	Geographic zone where the method is available. Leave --none-- if no restriction is needed.
Checkout hint	Text shown to the customer near the payment method.
Tranzzo test mode (XTS)	Testing mode with the XTS test currency.

6. Check Callback URLs

(if your site is on your own server)

For automatic order status updates, these URLs must be available:

https://<domain>/includes/callbacks/tranzzo_callback.php

https://<domain>/acquire_response.php

Open these URLs in a browser or ask a technical specialist to check them.
Make sure firewall, Cloudflare, or hosting rules do not block POST requests to the callback.
If you use an IP allowlist, add the Tranzzo IP from the official documentation or ask Tranzzo support for the current list.

Figure 6. Tranzzo documentation: webhooks

Warning. Tranzzo sends a callback/webhook to the store server. If the callback is blocked, the customer may pay successfully, but the order status in the admin panel will not update automatically.

7. Save and Test the Payment

Click Save and close.
Open the storefront and place a test order.
At the payment step, choose Tranzzo.
After redirecting to the payment page, the order is created with Default order status.
After successful payment, Tranzzo sends the callback and the order changes to Paid order status.
If you test in test mode, use the test card data from Tranzzo documentation.

Figure 7. Tranzzo documentation: test cards

Common Issues

Issue	What to Check
Tranzzo is not visible at checkout	Credit cards are enabled, Allow Tranzzo module is enabled, and the method is available for the selected zone. Also check the customer group settings: Tranzzo must be included in Payment Modules for the required group. If Shipping Modules are configured for the group or Ship 2 Pay is used, make sure Tranzzo is allowed for the selected shipping method.
Error after redirecting to payment	POS ID and all keys must come from the same Tranzzo project.
Test mode does not work	Use test project keys and enable Tranzzo test mode (XTS).
Order is created but status does not change	Callback URL is available, POST is not blocked by firewall/Cloudflare, and Secret Key is correct.
Payment is successful but the customer is not returned to the store	Check that https://<domain>/acquire_response.php is accessible.
Tranzzo returns an authorization error	Check POS ID, API Key, Endpoints Key, Secret Key, and test/production mode.