Documentation

Accept simple and secure payments in your native app with Judopay’s SDKs. Quickly capture your customer’s card details for immediate payments or save them securely for future payments.

Getting started is simple. Once you’ve signed up, you’ll receive access to your Judopay dashboard and the Sandbox environment.

You can begin testing and working with Judopay straight away. As with all financial technology there is a due diligence process to complete before you go live so please speak to a member of the team before doing any development work.

You can contact us at help@judopayments.com, by using our live chat service available from your dashboard or simply call us on 0203 503 0600 and select option 2 for support. Customer Support is available Monday to Friday 9am - 6pm.

When you are ready just let us know, we can look to activate your account and carry out testing so you can start processing payments. 


Overview

There are 4 methods to integrate with Judopay

  • Mobile and your server-side Standard method
    Use our customizable, native SDKs to let customers save cards in your mobile app and store the tokenized cards on your backend for future payments.
  • Web payments
    Use our hosted web payments optimized for mobile screens.
  • Mobile only
    Use our native SDKs for payments and your backend for everything else. A new way to integrate that is truly mobile.
  • Judopay Additions
    Use our customizable iframe solution to embed into your payments page for the best web experience.

How tokenization works

Judopay will tokenize your customer’s credit/debit card information for you to use in future payments. Tokenization ensures that your customer’s card information is collected and stored in a secure PCI-DSS compliant manner, minimizing your PCI liability as no card information is stored on your backend. This frees up your time to focus on developing other areas of your app.

Tokens will be passed back to you in the form of a callback if you integrate using ‘Mobile and your server-side’ or ‘Web payments’. If you chose to integrate using ‘Mobile only’, the token will be stored directly on the customer’s phone.

See Payments for more information on tokens and payment types, or for more information on PCI, please see the PCI compliance guide provided by the PCI Security Standards Council.

Ensuring a successful integration: The Setup section contains all the information and actions you will need for a successful integration. By following these steps, your app will be secure and provide a frictionless experience for you and your customers.


Select your integration method to get started

Mobile and your server-side Standard method

 

Use our native SDKs to let customers save cards in your mobile app and store the tokenized cards on your backend for future payments. There are 4 steps to this:

  1. Register card – Customer registers their card in your app.
  2. Response with tokenized card – Judopay will pass back the tokenized card information.
  3. Save tokenized card – You can then send these tokens to your backend.
  4. Token payment– Perform future payments using the token.

Judopay’s customizable UI comes with built-in checks and security features, including real-time error detection, 3D Secure and data and address verification for frictionless card data capture. Our SDKs are also fully loaded with mobile-specific fraud prevention tools and alternative payment methods, such as Apple Pay or Android Pay.

For this method, Judopay provides server SDKs for all repeat payments directly from your backend. You can also use our webhooks to notify your backend. If you do not use either of the languages below you can build directly to our API.

Mobile and your server-side · What to do next:


Web payments

 

Integrate simple and secure card payments into your website or web app with web payments optimized for mobile screens. There are 6 steps to this:

  1. Web payment request – Call Judopay’s web payment services.
  2. Redirect response – Judopay will respond with your URL.
  3. Redirect to hosted payments page – You redirect your customer to the payment page.
  4. Complete payment – User enters in their card details.
  5. Complete response – Judopay responds with success or decline.
  6. Redirect to success or decline – Judopay redirects your customer to the outcome that is specified by you for success or failure.

If you are aiming to host web payments with an app, please note that redirects slow everything down and user interfaces that don’t match your app make your customers feel unsafe, lowering your conversion rate. Native apps offer customers an optimal checkout experience that is simple, frictionless and secure.

Web payments · What to do next:

  1. Complete the Setup section to get started.
  2. Follow the Web payments guide or Build directly to our API.

Mobile only

 

The ‘Mobile only’ solution is a new way to integrate that allows you to minimize your integration time and cost as the fraud protection and payments will be taken care of by Judopay. In this option, you can use Judopay’s customizable native SDKs to process all of your payments.

There are 5 steps to this:

  1. Register card – Customer registers their card in your app.
  2. Response with tokenized card – Judopay will pass back the tokenized card information.
  3. Save tokenized card – The tokenized card is saved to the device.
  4. Token payment – Judopay’s SDK can perform all future payments using the token.
  5. Notifications – Judopay will update your system via a method that suits you, i.e webhooks.

In this method, refunds can be done via the Judopay dashboard or via the token you will receive from Judopay. You are responsible for storing card tokens on the consumer’s device. See Secure your mobile app.

Mobile only · What to do next:


Please note: In order to successfully go live and give your customers the best experience possible, we advise that you complete all the steps provided in the guides for your chosen integration method, including the ‘Setup section’, ‘Getting started’ and ‘Going live’ guides for your project.

Help & Support

If you have questions about anything not covered in our documentation, need assistance integrating, or are unsure where to go from here, our developer support team is here to help.

Contact us