Judopay Documentation


Glossary Definitions


Block threshold

The JudoShield Risk Score determines if a transaction is:

If the Block threshold is reached, the transaction and/or user is flagged, preventing them from completing this or any future transactions.

Card token

A card token is a randomly generated string linked to the saved card in Judopay’s systems.

It can be stored in your database without worrying about PCI compliance issues.

This card token can only be used with the associated consumer token.

Code obfuscation

Code obfuscation is the act of making source code difficult for a human to read.

Whilst it is not impossible to reverse engineer obfuscated code, the goal is to make it difficult or economically unfeasible.


The dashboard is Judopay’s online management tool. Create your app(s), get your token and secret, and configure your applications (permissions, webhooks, web payments URLs).

You can also view transactions, request refunds and settle funds.

Device DNA™

Device DNA™ is an essential component of JudoShield.

It enables Judopay to capture information about the mobile device to protect you from fraud in real-time.

In order to protect your app from fraud you must setup Device DNA™.

Device signals

Signals picked up from a device (i.e. mobile/cellular phone) that allows Judopay to power its fraud prevention product by recognising the behaviour of that particular device.

Judopay API

Judopay’s core API for processing transactions.


JudoShield is our mobile fraud prevention tool.

A risk engine that collects, analyses and returns a Risk Score between 0 and 100 for each transaction.

This is based on transactional data and mobile device signals – captured via Judopay’s SDKs.

Live Environment

Judopay’s live environment is accessed via the dashboard.

You transact in this environment upon successful integration. For testing live transactions, you would have to use live card details (real debit/credit cards).

Payment metadata

Allows you to populate additional information you’d like to have associated with a transaction.

This information is carried across on the receipt provided by Judopay, which can help reconcile transactions.

The property name and value are both limited to 50 characters and the whole object cannot be more than 500 characters.

Sandbox Environment

Judopay’s sandbox environment is accessed via the dashboard and is used for testing your app to ensure your integration is correct.

For testing sandbox transactions, use the Test Card Details.

Software Development Kit (SDK)

Judopay’s Mobile SDKs (including iOS, Android, Xamarin) enable you to accept payments easily in your app.

Judopay’s Server Side SDKs for PHP and .NET provide an easy to use interface for developers.

Token and Secret

A unique string of alphanumeric characters that you use to access the Judopay API servers.

You create the token and secret from within the dashboard and insert these into the headers of every request you send to Judopay.

You will need one set of tokens for the Sandbox environment and a separate set of tokens for the Live environment.