IRP Shopper
Common Tasks (1)
Open
Interventions (1)
Open
Languages (1)
Open
Questions & Answers (1)
Open
Reviews (1)
Open
Site Scripts (1)
Open
Web Services (1)
Open
Training Videos
Peer Support

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 knowm 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.

Information needed from Realex

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.

Information needed from Worldpay

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
Order Notification Configuration on WorldPay
 

AlternativePaymentMethodAccounts.aspx page

The AlternativePaymentMethodAccounts.aspx page appears as follows:

image

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 Method 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.

How To Guides (2)

Close
Close
How to Add or Edit a Local Payment Method Account

To add or edit an Local Payment Method/APM Account, proceed as follows.

  1. Go to Payment Processing > Local Payment Method Accounts in the IRP Admin left navigation menu.
  2. To add a new Account, click the Add New Account button at the top of the page. To edit an existing Account, click the Edit button in the row for the Account that you want to edit. You will then see the AlternativePaymentMethodAccountEdit.aspx page.
  3. Complete the following details as described in the sections that follow.

Settings for all providers

SettingDescription
Local Payment Method Account Details
Account 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 Customer's Billing Country matches one of the Permitted Billing Countries.
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 Select the Provider for this Local Payment Method. Currently the IRP supports Worldpay and Realex Payments for Local Payment Methods.
Charging Currency This is the currency that the Customer's Account will be charged in. Note that if this value is different to a Customer's Currency setting, selecting this Local Payment Method Account will force their Currency to the charging one.
Use Sandbox This 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 front-end website.

For a Worldpay provider

SettingDescription
Enter Credentials Select either 'Manually' or 'Copy from Card Processor'. The 'copy' option copies the Card Processor Credentials into the appropriate fields for this Local Payment Method Account. Click 'Insert' or 'Update' to save the Credentials against this Account.
Merchant Code The required Worldpay Merchant Code to be used in communication with the Local Payment Method Providers API.
Installation Id The Worldpay Installation Id for this Local Payment Method Account (you can usually determine this by contacting your Worldpay Account Manager).
XML Password The required Worldpay XML Password to be used in communication with the Local Payment Method Provider's API.
MAC Secret The required Worldpay MAC Secret to be used in communication with the Local Payment Method Provider's API.
Order Request Configuration
Requires Item Details If checked, the XML for Order Requests from this Account will include Item information according to the Processor's schema.
Requires Billing Address If checked, the XML for Order Requests from this Account will include the Customer's Billing Address according to the Processor's schema.
Requires Shipping Address If checked, the XML for Order Requests from this Account will include the Customer's Shipping / Delivery Address according to the Processor's schema.
Requires Statement Narrative If checked, the XML for Order Requests from this Account will include a Statement Narrative value, i.e. a value that will be displayed on any bank statement relating to a purchase on this site.
Terms and Conditions URL Overall Site Terms and Conditions URL to be used in XML Order Requests.
Billing Countries
Select Billing Countries / Permitted Countries Use the Add and Remove buttons to define the Billing Countries that this Local Payment Method Account is specifically enabled in (and vice versa). 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.

For a Realex Payments provider

SettingDescription
Enter Credentials Select either 'Manually' or 'Copy from Card Processor'. The 'copy' option copies the Card Processor Credentials into the appropriate fields for this Local Payment Method Account. Click 'Insert' or 'Update' to save the Credentials against this Account.
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.

Final steps

  1. Click the Insert Local Payment Method Account button or the Update Local Payment Method Account button.
  2. Click the Permitted Billing Countries tab and select the countries you want to permit to use this Local Payment Method.
  3. Click the Update Local Payment Method Account button to save your configuration.
Open
How to Test a Local Payment Method Account

Copyright © 2020 IRP Commerce. Use of this website constitutes acceptance of the IRP World Terms of Use, IRP Privacy Policy and IRP Cookie Policy

IRP Commerce Limited, Concourse 3, Catalyst, BT3 9DT, UK. Company Number: NI 041856. VAT Number: GB 888249658
A Deloitte Fast 50 Company seven times: 2010, 2011, 2012, 2013, 2014, 2018 & 2019