Worldpay¶
Overview¶
Worldpay is America’s most reliable payment processing provider. Mageplaza Worldpay extension helps integrate Worldpay to support online payment by card or Paypal, allowing customers to save credit card information at the first purchase to use it for the next payment. Customer can manage saved credit card information and delete card information at any time. In addition, the module also supports direct payment at checkout page (iframe) and support 3D Secure.
Mageplaza Worldpay extension is fully compatible with Mageplaza One Step Checkout.
Download and Install¶
How to use¶
- Worldpay: to register an account with Worldpay, you can access this link, click Sign up then fill in the required information below:
- After registration is complete, the system shows the thanks and requests to check and confirm via email registered:
- Open your registered mail, click the link below:
- You need to enter the password again then click Confirm Email to complete the registration:
- At the interface of worldpay, click
Settings> Orders
:
- At Orders, set Authorisations = Yes to enable the API feature:
- After enabling Authorisations, click API Keys, get the Service key and Client key to fill in the Configuration (will be guided at the second part):
Display Checkout: display by 2 types when paying by Worldpay:
- Magento Default:
- Iframe Checkout:
Display the Payment Method in the Order Backend:
- Stored Payment Methods: Here save the credit card information that customers have saved at the previous purchase. If you do not want to save old or unused credit cards, you can click delete to remove them.
- You can check the payment by some sample cards as following:
Test card numbers
Only the following credit/debit card numbers may be used for test payments in the test environment. When using test cards, you can specify an expiry date up to seven years in the future. The test cards do not have a card verification code or an issue number.
Card |
Number |
Mastercard Credit |
5555555555554444 |
Mastercard Debit |
5454545454545454 |
Maestro |
6759649826438453 |
Visa Credit |
4444333322221111, 4911830000000 and 4917610000000000 |
Visa Debit |
4462030000000000 |
American Express |
34343434343434 |
Simulate success and error flows
You can simulate different outcomes when submitting orders by entering the following values as the cardholder name:
Value |
Description |
SUCCESS |
Simulation of a successful payment |
FAILED |
Simulation of an unsuccessful payment |
ERROR |
Simulation of an error |
Visa Credit |
4444333322221111,4911830000000, 4917610000000000 |
Visa Debit |
4462030000000000 |
American Express |
34343434343434 |
- For other cases, please access here
How to Configure¶
Login to the Magento Admin, choose Stores > Configuration > Sale > Payment Methods
:
- At WorldPay Payment Method, click Configure:
1. Credentials¶
Login to the Magento Admin, choose Stores > Configuration > Sale > Payment Methods
, at WordPay Payment Method, click Configure > Credentials
:
- Environment:
- Admin can choose Sandbox environment to check payment features of methods.
- When you want to apply for online payment, admin needs to change the environment to Production.
- Service Key:
- Copy Service Key above and paste it here.
- If left blank or incorrectly entered, the payment method will not be connected.
- Client Key:
- Copy Client Key above and paste it here.
- If left blank or incorrectly entered, the payment method will not be connected.
2. General Settings¶
Login to the Magento Admin, choose Stores > Configuration > Sale > Payment Methods
, at Payment Method WordPay, click Configure > General Setting
:
- Merchant Country: The country that is used by the Worldwide Payment Gateway to determine which payment methods the shopper can use. Default is “EN”.
Example: Some payments depend on Merchant Country:
- Worldpay Alipay need to choose Merchant Country = China
- Worldpay Giropay need to choose Merchant Country = Germany
- Worldpay Ideal need to choose Merchant Country = Netherlands
- Worldpay Mistercash need to choose Merchant Country = Belgium
- Worldpay Paysafecard need to choose Merchant Country = United Kingdom
- Worldpay Postepay need to choose Merchant Country = Italy
- Worldpay Przelewy24 need to choose Merchant Country = Poland
- Worldpay Qiwi need to choose Merchant Country = Russia
- Worldpay Sofort need to choose Merchant Country = Germany
- Worldpay Yandex need to choose Merchant Country = Russia
Settlement Currency: Select the payment currency.
Language Code:
- ISO 639-1 language code indicates the preferred language of the shopper, where supported by the Payment Provider.
- Change language when Environment = Production.
Show Worldpay Logo: Select
Yes
to display the Cart logoSite Codes:
- Change currency from Currency to Settlement Currency column, if this field is blank, it will be taken from the Settlement Currency field above by default.
- Admin can add and delete site code.
3. Worldpay Cards¶
Login to the Magento Admin, choose Stores > Configuration > Sale > Payment Methods
, At Payment Method WordPay, click Configure > Worldpay Cards
:
- Enable: Select Yes to enable using the Worldpay Cards payment feature.
- Title: Enter the title of the method. The name of the payment method will be replaced displayed on the checkout page.
- New Order Status: Select status when customer order succeeds:
- Processing: Display status with Processing when order is successful. You can change the status in the backend with each order.
- Suspected Fraud: Displays status with Suspected Fraud when order is successful. You can change the status in the backend with each order. With this status admin can accept payment or reject payment and then transfer status to Processing.
- Payment Action:
- Authorize and Capture: Payment will be captured immediately after the order is placed successfully. At that moment, the customer’s card will be applied for the order and the Invoice will be created.
- Authorize: Payment will only be captured when admin creates an Invoice for customer’ s order. When the Invoice is successfully created, admin can receive money from customer’ s card.
- Card Types:
- Can choose 1 or more cards for payment.
- Cards will be authenticated when customers complete the card number at check out. For cards not selected in this section, there will be an invalid message for the customer if choosing them. With the card not selected, it will not be displayed on the Checkout page and backend order.
- 3D Secure: Select Yes so that after each payment display authentication with 3D Secure card verification of Customer:
Display Checkout: Select the type of display with Worldpay Cards payment:
- Magento Default: The payment method display of Worldpay Cards at the Magento default checkout page.
- Iframe Checkout: Show payment method of Worldpay Cards at inline type checkout page
Vault Enabled: Select Yes to display previously saved cards.
Vault Title: Enter the title of the method. The name of the payment method will be replaced displayed on Order Information:
- Payment from Applicable Countries:
- Select the All Allowed Countries to apply Card payment methods in all countries
- To restrict this payment with more conditions, see Payment Restrictions module.
- Select Specific Countries to limit certain countries to use this payment method
- Payment from Specific Countries: The selected countries will be allowed to apply the Card payment method.
- Minimum Order Total:
- Enter the minimum amount of order which allow applying specific payment by Worldpay Cards.
- If the order amount is smaller than the value in this field, the payment method will not be displayed.
- Maximum Order Total:
- Enter the maximum amount of order which allow applying specific payment by Worldpay Cards.
- If the order amount is greater than the value in this field, the payment method will not be displayed.
- Debug Mode:
- If select Yes, diagnostic information is stored in log files on the Magento web server.
- Sort Order:
- Choose the display position of this payment method compared to other payment methods
- 0 is the largest number. The smaller the number, the more priority will be displayed in the first position.
4. Alternative Payment Methods¶
Worldpay Paypal
Worldpay Alipay
Worldpay Giropay
Worldpay iDeal
Worldpay Mistercash
Worldpay PaySafeCard
Worldpay Postepay
Worldpay Przelewy24
Worldpay Qiwi
Worldpay Sofort
Worldpay Yandex
- Enable: Select Yes to enable the use of the selected Worldpay payment feature.
- Title: Enter the title of the method. The name of the payment method will be replaced displayed on the checkout page.
- Payment from Applicable Countries:
- Select the All Allowed Countries to apply Card payment methods in all countries
- To restrict this payment with more conditions, see Payment Restrictions module.
- Select Specific Countries to limit certain countries to use this payment method
- Payment from Specific Countries: The selected countries will be allowed to apply the Card payment method.
- Minimum Order Total:
- Enter the minimum amount of order which allow applying specific payment by Worldpay Cards.
- If the order amount is smaller than the value in this field, the payment method will not be displayed.
- Maximum Order Total:
- Enter the maximum amount of order which allow applying specific payment by Worldpay Cards.
- If the order amount is greater than the value in this field, the payment method will not be displayed.
- Debug Mode:
- If select Yes, diagnostic information is stored in log files on the Magento web server.
- Sort Order:
- Choose the display position of this payment method compared to other payment methods
- 0 is the largest number. The smaller the number, the more priority will be displayed in the first position.
5. Admin order¶
5.1. View order¶
This section records the information of Credit Card (WorldPay) that the customer has used to make orders:
5.2. Admin order¶
Admin can create order using WorldPay payment with the cards that customer has saved:
7. Compatible One Step Checkout¶
8. How to install Worldpay library¶
You need to run this command to install Worldpay library:
composer require worldpay/worldpay-lib-php