Skip to main content

Integration

Prerequisites​

If you don’t already have one, create a Wallee Portal account.

Installation​

  1. Update the composer.json file in the root directory of your Magento store and wait for Composer to finish updating the dependencies.

    composer require wallee/magento-2

  2. Enable the extension and clear the static view files.

    bin/magento module:enable Wallee_Payment --clear-static-content

  3. Register the extension and initiate the database migrations.

    bin/magento setup:upgrade

  4. Recompile the Magento project.

    bin/magento setup:di:compile

  5. Clear the Magento store’s cache.

    bin/magento cache:flush
info

If you install via FTP upload from our GitHub repositories, use the magento-2 repository for Magento 2.4 and above.

Configuration​

  1. Go to Stores > Configuration > Sales > Wallee Portal Payment in Magento.
  2. Enter your User ID, Authentication Key, and Space ID from Wallee Portal.
  3. Save the configuration. Payment methods will sync automatically.
warning

Most payment method settings are managed in Wallee Portal.

Line items​

You can control line item calculation under Stores > Configuration > Wallee Portal Payment > Line Items.

Payment method configuration​

  • Payment method settings are synchronized from Wallee Portal.
  • To change the payment method description, title or logo, update them in Wallee Portal — the change syncs to Magento automatically. See Payment Methods.

Order state mapping​

State in Wallee PortalMagento order state
Pending in Wallee PortalPending Payment
Authorized in Wallee PortalOn Hold Delivery
Fulfill in Wallee PortalProcessing

Invoice state mapping​

State in Wallee PortalMagento invoice state
Authorized in Wallee PortalInvoice Pending
Paid in Wallee PortalInvoice Paid

See Transaction States for what each state means.

Transaction management​

You can capture, void and refund transactions in Magento.

warning

Captures, voids and refunds done in Wallee Portal are synchronized to Magento only with limitations. Perform them in Magento — otherwise your Magento orders and invoices can end up out of step with the actual payment. See Refunds for how refunds work on the platform side.

On-hold orders​

Orders remain On Hold if:

  • the transaction is not yet completed, or
  • a manual task exists in Wallee Portal.

Manual tasks appear both in Wallee Portal and in the Magento backend — see Manual Tasks.