You need your sandbox account so you can process test transactions while developing your app.

Sign up for your sandbox account here.

Once you have signed up, you will receive your:

Get access to your dashboard in the Judopay Portal.

Here you can create your app.

Creating your App

From the Judopay Portal:

Step	Description
	From the side menu, select Your apps
	The Your apps page appears. Click the Add app button.
	The app configuration page appears. Enter the name for your app. For the purpose of this exercise, Documentation Testing App is entered.
	To enable pre-configured permissions depending on the kind of app you are creating, select one of the following options: Native Mobile: Payments using our native Mobile. Web Payments: Using our hosted re-direct Web Payments solution. Your Back Office: Using our Server SDKs, or build directly to our API. See Getting Started with our API.
	Click Add app
	Your new app will appear at the bottom of the list of apps. You can select the app to view and edit the configuration settings.

Note

Each app has a unique configuration, meaning permissions or feature configurations (such as one-click payments) are not shared between all your apps.

You have to configure each app separately.

 

For more details about app permissions, see App Permissions.

Before you get started, see the Important key fields that need to be sent between your app and Judopay when making payments:

Unique Judo ID

Your Consumer Reference

Your Payment Reference

A token and secret pair is a method to authenticate and enable access to secure data.

Token:

The token is used in conjunction with the secret to authenticate the request.

Secret:

The secret is the ‘password’ that is used to authenticate against the token. It is known as a token and secret pair because a token is associated with its secret (the pair). Together they work to confirm the identity and authentication of a payment.

Each app has a Token and Secret Pair for Sandbox and Live. 

Token:Secret App Permissions

You can create more than one set of tokens for a single app, depending on your requirements and app usage. Each token and secret pair will have specific permissions, they are not shared between all your apps.

You will have to configure and set the following permissions separately for each app :

Token:Secret Additional Settings

At the APIToken/APISecret level, additional settings can be initiated:

Token and Secret Permissions

Each Token and Secret pair will have specific permissions configured.

Tip

Double check these permissions before using the Token and Secret.

Each app has a Token and Secret Pair for Sandbox and Live.

To view the Sandbox Token and Secret in the Judopay Portal:

STEP	DESCRIPTION
	From the side menu, select Your apps Select the app to view the Token and Secret credentials
	Select Sandbox tokens to see both the Token and Secret for the Sandbox Environment.
	The Sandbox Token information is displayed. You can: View the Token | Secret | View and Edit Permissions | Disable the token | Add a new Sandbox token

Note

A live Token and Secret will only be visible within the app once your account is activated.

The Payment Services Directive (PSD2), has introduced a new regulatory requirement: Strong Customer Authentication (SCA). The aim of the SCA is to add an increased layer of security for card not present transactions, when making mobile and online payments.

For more information, see Upgrading to 3D Secure 2 (EMV 3D Secure).