---- dataentry gateway ----
type            : gateway         # do not change this line

# Add the full name of the gateway after the colon below.
name            : PesaPal

# Supported Countries. Please use 2-character ISO Country Codes available at
# http://www.iso.org/iso/english_country_names_and_code_elements
# Separate multiple country codes by commas.
countries       : 

# Enter the FoxyCart versions where support was added or removed (if applicable).
# Version numbers should include applicable decimals, such as "0.7.0" and not "070"
support-added   : 2.0.0
support-removed : 

# Features and Details
auth-net-emulation :  # enter "yes" or "no" (without quotes)
supports-3dsecure  :  yes # enter "yes" or "no" (without quotes)
supports-multicurrency  :  # enter "yes" or "no" (without quotes)

# Gateway URL
gateway_url     : https://www.pesapal.com
----


====== PesaPal ======
<WRAP center round important 90%>
Subscriptions are not supported with PesaPal at this time. If you intend to sell subscriptions with your FoxyCart store, you will need to make use of another payment gateway.
</WRAP>
===== Setting Up PesaPal for FoxyCart =====

<WRAP center round important 90%>
**Important:** Ensure all the following steps are completed for your PesaPal account, as without it transactions could fail to complete correctly.
</WRAP>

  - Login to your **PesaPal Merchant account** and click on **IPN Settings** in the menu
  - In the **Website Domain** enter ''https://YOUR-STORE.foxycart.com''
  - In the **Website IPN Listener Url** field, enter ''https://YOUR-STORE.foxycart.com/ipn.php''
  - **Important** For the last two steps, ensure you change the URL's to match your actual FoxyCart store domain. For example, if your FoxyCart store domain was ''example.foxycart.com'', you would set the Website Domain to ''https://example.foxycart.com'' and the IPN Listener Url to be ''https://example.foxycart.com/ipn.php''. If you had a custom subdomain set up for your store though, and it was instead something like ''secure.yourstore.com'', the Website Domain would be ''https://secure.yourstore.com'' and the IPN Listener Url would be ''https://secure.yourstore.com/ipn.php''.

{{ :gateways:merchant_ipn_settings.png?direct&400 |}}

===== Testing =====
==== Obtaining a Test Account ====
<WRAP center round important 90%>
**Please Note:** Foxy's test account that can be used within the Foxy admin is set up only to work with a locale of Kenya with ksh currency. To test for your own store, you'll need to get a test account with PesaPal that supports your currency.</WRAP>

Contact PesaPal for info on obtaining a test account. <wrap help>Know more? Feel free to edit this page with info.</wrap>

==== Test Card Numbers ====
When on test servers, the card number to use to test a card is right below the card number field on the payment form.



===== Troubleshooting & Interpreting Response Codes =====
Contact pesapal for info. <wrap help>Know more? Feel free to edit this page with info.</wrap>



===== Important Notes and Caveats =====

==== Possible Action: Datafeed Handling ====

At the time of the customer completing the transaction - we don't necessarily know whether the transaction was completed yet or not. We instead rely on a notification from the gateway after the checkout has been completed to confirm whether the transaction was approved or not. To handle this, transactions are initially marked as pending, and when we get a confirmation from the gateway on the result of the transaction, we update it accordingly. Each time the status changes, a datafeed will be sent to your endpoint if configured with the transaction details and the ''status'' node will be present.

The ''status'' node can contain one of three different values: ''pending'', ''approved'' or ''rejected''. Depending on the types of actions you're needing to perform at your datafeed endpoint, you need to make sure the appropriate status value is present first.

===== User Notes and Experiences =====
<wrap tip>If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date.</wrap> We reserve the right to edit or remove comments that don't add value to this page.