Common causes of a failed integration / signature mismatch

Common causes of a failed integration / signature mismatch

The following will cause a signature mismatch or a payment to fail:

  1. This is most likely caused if you generated the MD5 hashed string with the variables in the wrong order.
  2. A required field is missing.
  3. A field is greater than the allowable character length.
  4. Any of the fields containing excess or invalid characters.
  5. The parameter string has been URLencoded incorrectly. The resultant URLencoding must be in uppercase (eg. http%3A%2F%2F) and not lower case like http%3a%2f%2f, and spaces encoded as ‘+’.
  6. The parameter string has not been trimmed of white spaces on the ends.
  7. The passphrase, if used, must be identical on your PayFast account as well as the site, and may consist only of letters, numbers and -_/.
    Should you wish to set up recurring billing, then you will need to have a passphrase set and recurring billing enabled on your account in order to prevent the signature mismatch error.
  8. You will need to ensure that the MD5 hash characters are in lower case.

    • Related Articles

    • Why am I getting a signature mismatch error on WHMCS?

      If you are using a WordPress installation along with a WHMCS bridge plugin, the cause is that the WordPress plugin modifies the output of the values sent through to PayFast. In order to fix this, you need to comment out the signature generation part ...

    • In WooCommerce, why am I getting error ‘Signature is required’?

      If the setting for ‘Require Signature’ has been enabled on your PayFast account, this error message will occur since the WooCommerce plugin does not make use of the signature at checkout. This setting can be edited and disabled by logging in to your ...

    • How does the Xero integration work?

      Our integration with Xero is all automatic. It will update Xero when a successful payment is received by PayFast via a Xero invoice (or if a payout from PayFast is made). However, it will not automatically sync or update payments made from other ...

    • What kind of technical support does PayFast offer for custom integration?

      The PayFast Technical Support team can assist with integration issues related to our Developer documentation.  We won’t be able to resolve the following issues (but may be able to offer advice in certain situations): The building of the checkout ...

    • How do I test if the Xero integration is working?

      Once Xero is enabled by following these instructions, you will be able to test the integration by creating a test invoice and emailing it to your email address.