Documentation You are here: start » gateways » pawapay

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
gateways:pawapay [2025/06/13 15:36] – [Setting Up pawaPay for FoxyCart] adamgateways:pawapay [2025/07/04 10:41] (current) – [''INVALID_AMOUNT''] adam
Line 31: Line 31:
   - Within the settings for it, paste the API Token you generated from the pawaPay administration into the API Token text input and save   - Within the settings for it, paste the API Token you generated from the pawaPay administration into the API Token text input and save
  
-==== Store currency ====+==== Country restrictions and potential currency conversions ====
  
-When configuring your Foxy store for pawaPay, ensure you set the store's locale to one that matches the currency that your PawaPay is set to accept payments in. As part of the integration with pawaPay, no currency is passed, so whatever amount the checkout total is will be assumed as being in the currency of your pawaPay account when the customer is redirected there for payment.+Within your pawaPay account, you can specify which carriers are supported for payment, which in turn restricts what countries are supported for customers.
  
-Foxy store locales are configured within the template sets for your store.+The Foxy integration for pawaPay uses the countries that are supported for the accounts carriers to determine which countries are allowed for payments through pawaPay. If a customer tries to complete the checkout with an address from a country that is not supported by one of the carriers of your pawaPay account, the checkout will error and let the customer know that the customer is not supported.
  
 +If the country is supported by a carrier on your pawaPay account, then the customer will be forwarded on to the pawaPay hosted payment page. If the currency of the cart does not match the currency for that country though, the total amount will be automatically converted to that currency to ensure that the amount the customer pays is in the correct currency. If the currency of the cart matches the currency of the country carrier, no currency conversion will happen.
  
-At this point, if you add a product to your Foxy store and proceed to the checkout, you should see the pawaPay payment option available on the checkout+This currency conversion will also happen when triggering partial refunds, which depending when the refund occurs, the conversion rate could be different than when the initial purchase occurred. Full refunds will always refund the full amount in the converted currency that was originally paid.
  
 ===== Testing ===== ===== Testing =====
Line 50: Line 51:
  
 ===== Troubleshooting & Interpreting Response Codes ===== ===== Troubleshooting & Interpreting Response Codes =====
 +
 +==== ''INVALID_AMOUNT'' ====
 +
 +The carriers supported by pawaPay have specific limits for minimum and maximum amounts that they support for payments. These can be unique to the individual carriers supported for a country. If you exceed these limits, the attempt will error with something like this:
 +
 +<code>The provided 'amount' should fall within the limits of 1 and 2000000.</code>
 +
 +Note the values will be relative to the currency supported by the carrier.
 +
 +==== Other errors? ====
 +
 Contact pawapay for info. <wrap help>Know more? Feel free to edit this page with info.</wrap> Contact pawapay for info. <wrap help>Know more? Feel free to edit this page with info.</wrap>
  

Page Tools

Site Tools