Connect CS-Cart

The Payfim add-on registers a Payfim Crypto Payments processor in CS-Cart and prepares a Pay with Crypto payment method. Customers pay on your own Payfim Gateway and orders move to Processed automatically when the payment is confirmed on the blockchain.

Before you start, install your Payfim Gateway and add your wallets (see Install the gateway and Add wallets). Compatibility: CS-Cart & Multi-Vendor 4.3 – 4.x · PHP 7.4 – 8.4.

1. Install the add-on.

   In the CS-Cart admin open Add-ons > Manage add-ons, click the + button (Upload & install add-on) in the top right corner, choose payfim-cscart.zip and click Upload & install. Payfim Crypto Payments appears in the list as Active.

   Tip: Without upload rights? Unzip the archive and copy the app, design and var folders into your CS-Cart root, then install the add-on from the Browse all available add-ons tab.

2. Open the payment method.

   Go to Administration > Payment methods. The add-on created Pay with Crypto (disabled). Click it. On the General tab you can change the name and description customers see; the processor is Payfim Crypto Payments.

3. Enter your gateway details.

   Open the Configure tab and enter the Gateway URL (e.g. https://pay.yourstore.com) and the API key from your gateway admin (Integrations). The order statuses are pre-set: Open while waiting, Processed when paid, Awaiting call when underpaid and Failed when the quote expires. Click Save and set the status to Active.

   Tip: The API key field is a password field and stays empty after saving; leave it empty to keep the saved key.

4. Test the connection.

   Open the payment method again, go to Configure and click Test connection. A green notification confirms the gateway version and the coins you accept. Webhooks need no setup: the webhook URL shown on the Configure tab is sent to the gateway with every invoice.

5. Paid orders.

   At checkout customers pick Pay with Crypto, place the order and are sent to your gateway. The order is Open while waiting and becomes Processed when the payment is confirmed. In Orders > View orders the order's payment information shows the Payfim invoice, coin, amount received and the blockchain transaction ID.

   Tip: Underpaid payments are never marked paid: the order goes to Awaiting call with a note "Only X of Y received".

Troubleshooting

Pay with Crypto is not shown at checkout

Check that the payment method status is Active, that it is available for the customer's user group and (Multi-Vendor/Ultimate) for the storefront/vendor.

"Crypto payment is temporarily unavailable" after placing the order

The store could not reach the gateway; the order stays incomplete and the customer can choose another method. Click Test connection and check the Gateway URL, the API key and outgoing HTTPS on your server.

Order stays Open after paying

The gateway could not deliver the webhook to index.php?dispatch=payment_notification.notify&payment=payfim. Check the webhook log on the invoice in your gateway admin; the storefront must not be closed or behind HTTP authentication.

Need details

Tick Debug logging in the Configure tab; entries are written to var/payfim/payfim-YYYYMM.log.

Get the CS-Cart Crypto Payment Add-on - the download includes an illustrated PDF version of this guide.