This guide will walk you through the process of integrating Fintoc into your Magento store. By following these steps, you'll be able to offer a seamless payment experience to your customers and boost your sales.

Prerequisites

Before you start, you need:

• A Fintoc account with API credentials (Secret Key and Webhook Secret).
• Admin access to your Magento 2 store.
• Developer access (if you need to install or update the module).

You can find your API credentials in the Fintoc Dashboard.

Getting Started: Credentials and Setup

1. Sign Up

To initiate the process, head to Fintoc's dashboard and sign up. To start receiving payments in Live mode, fill out your information to facilitate account activation and provide you with the necessary credentials.

2. Obtain API Keys

Within your Fintoc dashboard, you will find both Test and Live API Keys. You should use your Live API Keys to setup Fintoc within Magento.

To get your Live API Keys, make sure you are in Live mode by checking the button on the top left of our dashboard. Then, head over to For Developers → API Keys to obtain them.

Integration and Configuration Process

Installation (if not preinstalled)

Ensure the module is installed and enabled by your developer or partner.

• Example (for developers):
  • composer require fintoc/module-payment
  • bin/magento module:enable Fintoc_Payment
  • bin/magento setup:upgrade
  • bin/magento cache:flush

Enabling the Plugin in Your Magento Store

1. Log in to your Magento Admin panel.

2. Go to Stores → Configuration → Sales → Payment Methods → Fintoc.

   

3. In Basic Settings, enter:

   • Secret API Key (from the Fintoc Dashboard)
   • Webhook Secret (from the Fintoc Dashboard, this is explained in the next section.)
   • (Optional) Adjust logging and debug settings: Enable Logging, Debug Mode, set Debug Level, and toggle Log Sensitive Data

4. In Payment Initiation, configure:

   • Enabled: Yes
   • Title: Display name (e.g. Pay with Fintoc)
   • Automatically Invoice All Items (optional)
   • New Order Status: usually Pending or Processing depending on your invoicing policy
   • Applicable Countries: all or selected
   • Maximum Order Amount (optional)
   • Sort Order (checkout display order)

5. In Refunds (optional):

   • Enable Refunds and Partial Refunds
   • Enable Auto-create Credit Memo
   • Define status transitions for Refund events (Pending, Succeeded, Failed, Canceled)

6. Click Save Config, then clear caches if prompted.

Managing Magento's Admin

For transactions

1. Go to Sales → Fintoc → Transactions in the Magento Admin.

   

2. Use filters to search by order or transaction ID.

   

3. Click any transaction to view details and webhook logs.

   

You can issue refunds directly from Magento:

1. Go to Sales → Fintoc → Refundable Orders, open the refund form, and submit.

   

2. Or use the standard Credit Memo flow if configured.

Magento will automatically send refund requests to Fintoc and update statuses accordingly.

Webhook setup

To keep payment statuses synchronized:

1. In your Fintoc Dashboard, create a new webhook.

   • Set the URL to {STORE_URL}/fintoc/webhook
   • Method POST

2. Copy the Webhook Secret and paste it into your Magento Fintoc settings (Stores → Configuration → Sales → Payment Methods → Fintoc → Basic Settings → Webhook Secret).

3. Test delivery in Fintoc and verify Magento responds with 200 OK.

   

Best practices

• Keep logging enabled in production at a reasonable Debug Level. Avoid logging sensitive data unless requested by support.
• Verify that your server is publicly reachable by Fintoc for webhooks (firewalls, maintenance mode, IP allowlists).
• If customers report missing payment method, check country restrictions and maximum order amount settings.

Troubleshooting

Here are some issues you might encounter and how to solve them.

Support

• Provide recent entries from var/log/fintoc*.log when contacting support.
• Share the order increment ID and (if available) the Fintoc transaction_id for faster diagnosis.

Testing

1. In Fintoc's app, switch to Test mode by using the checkbox to test payments without affecting live orders.
2. Place test orders to ensure that payments are processed correctly. For more information on testing, refer to our testing guidelines.

Go Live

1. Once you're satisfied with testing, switch the app to Live or Production mode by unchecking the checkbox.
2. Test a few more orders in the live environment to ensure everything is functioning as expected.

Congratulations! Your Magento store is now fully equipped to accept payments through Fintoc, enhancing the shopping experience for your customers and driving up your sales.

FAQs

Q: How do I handle refunds and disputes?

A: Refunds can be managed directly within your Magento dashboard. Navigate to an Order, where you'll find a Refund button on the top-right corner. Here, you can input the refund amount and any comments you wish to track. For more details on how refunds work in Fintoc, consult our Refunds Guide.

🚧

Refunds for E-Commerce Plugins

You can issue refunds directly from your e-commerce platform (Magento, VTEX, Shopify), but due to how the plugins work, refunds requested from e-commerce plugin platforms cannot be cancelled from their dashboards.

If you issued a refund from one of these platforms and wish to cancel it, you can use our Cancel Refunds API endpoint or contact our support team, but please consider that the cancellation will not be reflected in your Magento, VTEX or Shopify Dashboard