To set up a Kenyan Merchant, follow these steps:




1. Retrieve Credentials and set up 3D-Secure:


  • You receive all the credentials needed to do the setup from Equity Bank, except the API Password.
  • To generate and retrieve the API Password; we use the below credentials, which you will receive from the Account Manager:


URL: https://ap-gateway.mastercard.com/ 

MID: 

Operator ID: 

Password:


  • Navigate to "Integration Settings", as seen in the below screenshot:



  •  Click "Generate New" to get a new API Password, tick the box, copy the password, and click save:





  • Next, navigate to "Transaction Filtering -> 3-D Secure Rules" to set up 3D Secure on the merchant profile:




  • Ensure the following are always ticked, and when instructions specify to set to fully 3D authenticated, ensure the final box is also ticked:






2. Create the Merchant Account in the Peach Console:


  • Under Merchant Accounts -> New Merchant account -> Clearing Institute = Enquity Bank:


  • Next, set up the Live Credentials with the Merchant ID receive from EB, and the API Password you generated:


  • NB: Do not switch "Support 3D Secure?" to active here!



  • Lastly, create a new Channel, name it, and attach the merchant account to that channel.




3. Navigate to the BIP to complete the Setup:


  • First, navigate to "Admin -> Account Data"
  • Search for the Merchant name -> select it.
  • Look for "Available Merchant Accounts" and find the account you just set up:




  • Ensure Merchant Region is set to "Asia Pacific":



  • Next, go to the CHANNEL LEVEL, and then navigate to "Risk Management -> Risk Checks -> External Checks -> 3D Settings" and ENABLE 3D Secure on the channel level:



  • Then, on the MERCHANT LEVEL, navigate to "Blacklist -> BIN Blacklist" - "BIN Type = BIN_Country":


  • Upload the "CountryByBIN_whitelist_KE.csv" document attached at the bottom of this article


  • Lastly, navigate to "Risk Management -> Risk Checks -> Blacklists and Whitelists -> Individual Whitelist Country by BIN (iw.cb)" and set to TRUE: