Local Payment Method Accounts

You can find this section under Payment Processing > Local Payment Method Accounts in the IRP Admin left navigation menu.

Local Payment Methods (also known as 'Alternative Payment Methods' or 'APMs') allow you to focus on your most valuable Shipping Countries. Examples of Local Payment Methods/APMs include:

• Alipay
• Banamex
• Banco do Brasil
• Bancomer
• Boleto
• Bradesco
• eNETS
• Entercash
• EPS
• Finnish Online Banking
• Giropay
• iDEAL
• MyBank
• Multibanco
• P24
• Paysafecard
• PayU
• POLi
• PostFinance
• Qiwi
• SafetyPay
• SEPA Direct Debit
• SEPA Payout
• Skrill
• SOFORT Banking
• Trustly
• TrustPay
• UnionPay
• WeChat Pay
• Zimpler

For each Local Payment Method to be enabled in your IRP, you will need to add an account on this page. Here is where you add the Worldpay and Realex details. This is also where you configure the Currency - Billing Countries combinations for an account.

To enable Local Payment Methods/APMs through Realex, you need the following information from Realex:

• Merchant ID: The Realex Merchant ID to be used in communication with the Local Payment Method Providers API.
• Sub Account: The Realex Sub Account for this Local Payment Method Account (you can usually determine this by contacting your Realex Account Manager).
• Shared Secret: The required Realex Shared Secret to be used in communication with the Local Payment Method Provider's API.
• Refund Password: The required Realex Refund Password to be used in communication with the Local Payment Method Provider's API.

To enable Local Payment Methods/APMs through Worldpay, you need the following information from Worldpay (see also the screen capture below):

• Merchant Code with desired Local Payment Methods enabled
• Unique Installation Id for their Integration between IRP and Worldpay
• XML Password for communication between IRP and Worldpay
• MAC (Message Authentication Certificate) Secret for verifying messages from Worldpay
• Order Notifications configured for automatic updates of Pending Local Payment Methods/APMs:
  • Protocol: HTTP
  • Active: Yes
  • Content: XML
  • Address: https://www.domainname.com/Secure/AlternativePaymentMethodsOrderNotificationsWorldPay.aspx
    Note there are different URLs for training and production - you should set both to be the same unless you are testing sandbox on a test site and production on your live site.
  • Method: POST
  • Client Certificate: No
  • Send Indempotency Key: No

The AlternativePaymentMethodAccounts.aspx page appears as follows:

You can use the Search function above the main grid to find any account using the following drop-down filters:

• Provider
• Country
• Currency

You can see the following details in the main grid:

• ID: This is the unique IRP identifier for this Local Payment Method Account, added automatically by the IRP.
• Active: Only Active Accounts will be available on the front-end checkout process if the Billing Country - Currency criteria have been met.
• Payment Method: This is the Payment Method for this Local Payment Method Account. This will determine what Method Code is sent in the XML communication with the Provider API.
• Provider: This is the Provider for this Local Payment Method. Currently the IRP only supports Worldpay (and soon Realex) Payments for Local Payment Methods.
• Billing Countries: These are the Billing Countries this Local Payment Method Account is specifically enabled in. If no Billing Countries have been enabled against an Account, it will be available to all Countries providing the Customer's Currency matches the Currency of the Account. If Billing Countries have been enabled against an Account, it will only be available in those Countries providing the Customer's Currency matches the Currency of the Account.
• Charging Currency: This is the Currency criteria for this Local Payment Method Account. Local Payment Method Accounts are unique for Billing Country - Currency combination. Unless these two criteria are met in the checkout process, the Account will not appear to the Customer.
• Merchant Identifier: This is the required Merchant Code to be used in communication with the Local Payment Method Providers API.
• Sandbox Mode: Determines whether Transactions placed using this Local Payment Method Account use the Sandbox or Production environment of their Provider's API. Note that Local Payment Method Accounts in Sandbox mode should be kept InActive to prevent them from appearing on the website front-end.
• Delete: Click this button to delete an account configuration.
• Copy: Click this button to duplicate an account configuration and then amend it as necessary.
• Test: Click this button and the AlternativePaymentMethodTestTransaction.aspx pop-up window will appear. Using this window you can submit a test transaction using a test amount of the Local Payment Method currency and a billing country. For more details, see How to Test a Local Payment Method Account.
• Edit: Click this button to go to the AlternativePaymentMethodAccountEdit.aspx page. From here you can edit all the details of an existing Local Payment Method Account. For more details, see How to Add or Edit a Local Payment Method Account.

At the top of the page you can use the following buttons:

• Transactions: Click this button to go to the AlternativePaymentMethodTransactions.aspx page. Here you can see lists of all the Local Payment Method/APM transactions in the system and you can drill down to examine each transaction in greater detail on the AlternativePaymentMethodTransactionDetails.aspx page where you can see the response content and other information. For more details, see the How to View Local Payment Method Transaction Details help topic.
• Payment Methods: Click this button to go to the AlternativePaymentMethods.aspx page. You will need to add each Local Payment Method that you want to implement on your IRP on this page. For more details see the Local Payment Methods help topic.
• Add New Account: Click this button to go to the AlternativePaymentMethodAccountEdit.aspx page. From here you can add all the account details for a new APM. For more details, see How to Add or Edit a Local Payment Method Account.
• View All Accounts: Click this button to view all the accounts that have been configured in the system. The results are shown in the grid.