Common NETBANX errors

... and solutions

Need help? In a rush?!

If you just need someone to get your system working quickly get in touch!

Common errors, causes and solutions

  • "Merchant Reference 'EXAMPLE' has already been processed. Please contact Merchant Customer Services"
  • Explanation

    This error means that the merchant reference parameter you passed to NETBANX has been passed before. It needs to be different each time so make sure the value isn't hardcoded! (A common mistake is to set your merchant reference to be your merchant ID instead of your order ID.)

    Solution

    The parameter is often called 'nbx_merchant_reference' so check your code / settings and make sure this is being set to your order ID or reference correctly. Make sure this value is unique for every order!


  • "Not a valid currency" and / or "No currency"
  • Explanation

    This error means you are either not passing the currency type or you are not passing a valid currency type for the transaction. For every transaction NETBANX requires you pass a parameter specifying the currency code to use. (Even if you always trade in the same currency you still have to tell them every time!)

    Solution

    This parameter is often called 'nbx_currency_code' and if you are trading in the British pound it should be set to 'GBP'. If you are still having problems double check your specification to see if your integration uses a different parameter name.


  • "Could not get a reference"
  • Explanation

    This error is most commonly caused by trying to trade in a currency you haven't yet been set up for. For example you might have a GBP and USD merchant account but if your NETBANX integration is only set up for GBP if you pass a currency code of 'USD' you will receive this error. (There are some other reasons this error might be displayed too.)

    Solution

    Make sure you are passing the correct currency code parameter (usually called 'nbx_currency_code' and most commonly set to 'GBP' for British pounds). If that has been set correctly you need to phone NETBANX technical support, it's worth checking if the error only occurs when you try and perform a transaction in certain currencies to help them diagnose the problem.


  • "(705) This page can only be viewed when linked to from the merchant's website"
  • Explanation

    To ensure customers have come from your website NETBANX performs a check. If the webpage address (referring URL) is wrong this message will be displayed.

    Solution

    Firstly check the URL/address of the webpage directly before the NETBANX payment form, write this down. Now check that it matches what's in your specification, even small mistakes can cause a problem. If they don't match try changing the page's address to match what NETBANX is expecting. If that's not possible or they already match you will need to phone them. (Ask for you referrer URLs to be changed and give the address you wrote down earlier.)


  • "* NetBanx Server Error"
  • Explanation

    This error is displayed when you try to process a transaction with an amount of 0. You can't process a transaction for no money!

    Solution

    Make sure you are passing the payment amount properly to NETBANX. Make sure it's not empty, it's formatted correctly and that the number isn't 0.