Judopay Documentation

The Mobile only solution allows you to use Judopay’s customizable native SDKs to process all of your payments.

Steps:

	REGISTER CARD Customer registers their card in your app
	RESPONSE WITH TOKEN Judopay will pass back the tokenized card information
	SAVE TOKEN The tokenized card information is saved to the device
	TOKEN PAYMENT Judopay’s SDK can perform all future payments using the token
	NOTIFICATIONS Judopay will update your system via a method that suits you (web hooks). Using web hooks, you can process refunds via the Judopay Portal Dashboard or via the Token you will receive from Judopay.

To enable consumers to save their card details in your mobile app:

Mobile SDK

Server SDK

If you do not use PHP or .Net, you can build directly to our API.

Steps:

	REGISTER CARD Your customer registers their card on your mobile app
	RESPONSE WITH TOKEN JudoPay will pass back the token to you
	SAVE TOKEN You send the token to be stored on your server
	TOKEN PAYMENT All future payments can be performed using the stored token

To build a secure mobile app:

Android: Values placed in strings .xml are stored in clear text.

This is extremely vulnerable from a security perspective.

iOS: Best practice is to store credentials in the Keychain.

This is stored securely and only available to the app vendors.

Your Credentials

Your Judopay credentials allow you to perform transactions, so it is vitally important you protect them from falling into the wrong hands.

In general, it is relatively easy to decompile an app and get at the source code. 

When embedding your credentials and hard coded strings into the app, they can be easily extracted, so we recommend not to directly paste in your credentials.

Judo judo = new Judo.Builder()
    .setApiToken("xxxxxxxxxxxxxxxxxx")
    .setApiSecret("xxxxxxxxx")
    .setEnvironment(Judo.SANDBOX)
    .build();

We recommend you define a set of variables in an unrelated part of the application and pass the variables into the initialization.

The variable names will be obfuscated (assuming you use an obfuscation tool):

udo judo = new Judo.Builder()
    .setApiToken(token)
    .setApiSecret(secret)
    .setEnvironment(Judo.SANDBOX)
    .build();

To further enhance security, we recommend:

This results in making it harder for a human to understand the importance of the variables. 

It is also recommended to define the variables in various locations in your app, to make it as hard as possible to piece together.

var tokenPart1 = "xxxxxxxx";
var tokenPart2 = "xxxxxxxxxxxxx";
var tokenPart3 = "xxxxxxx";
var secretPart1 = "xxxxxxxxxxxxx";
var secretPart2 = "xxxxxxx";
initialiseJudo(tokenPart1 + tokenPart2 + tokenPart3, secretPart1 + secretPart2)

Getting Started

Integrate simple and secure in-app card payments into your Android app. See our sample app for more information.

Integration Requirements

Supported Card Networks

Address Verification Service (AVS)

Fragments

You can integrate with the SDK via two methods:

For examples on how to integrate the SDK, see our sample app for more information.

Requirements

Installing React-Native

"postinstall": "node node_modules/judo-react-native/scripts/sample-app_postinstall.js node_modules/judo-react-native"

2. Under the dependencies section add:

"judo-react-native": "file:../",In your root project folder run:sh rm yarn.lock && rm -rf node_modules yarn install

3. Navigate to ios/ folder and run: 

sh rm -rf Pods/ && rm Podfile.lock pod install

To run the JudoPay React Native SDK:

1. Import:

import {
  RNJudo,
  type JudoOptions,
  type JudoApplePayOptions,
  type JudoGooglePayOptions,
  type PaymentOptions
} from "judo-react-native";

Configure the JudoOptions object:

const judoOptions: JudoOptions = {
  token: "<TOKEN>",
  secret: "<SECRET>",
  judoId: "<JUDO_ID>",
  isSandbox: true,
  amount: "0.01",
  currency: "GBP",
  consumerReference: "myCustomerReference",
  paymentReference: "myPaymentReference",
  metaData: {metadatakey: "metadataValue", metadatakey2: "metadataValue2"}
};

You will have to pass the judoOptions object each time you want to make a call to the JudoPay React Native SDK.

try {
  let response = await RNJudo.makePayment(judoOptions);
  if (response.result === "Success") {
    //Handle successful result
  } else {
    //Handle unsuccessful result
  }
} catch (e) {
    //handle error
}

try {
  let response = await RNJudo.makePreAuth(judoOptions);
  if (response.result === "Success") {
    //Handle successful result
  } else {
    //Handle unsuccessful result
  }
} catch (e) {
  //handle error
}

const paymentOptions: PaymentOptions = {
  paymentMethods: RNJudo.PAYMENT_METHOD_NONE
};

Payment method types: {
  RNJudo.PAYMENT_METHOD_NONE
  RNJudo.PAYMENT_METHOD_CARD
  RNJudo.PAYMENT_METHOD_GOOGLE_PAY
  RNJudo.PAYMENT_METHOD_APPLE_PAY
  RNJudo.PAYMENT_METHOD_ALL
}

try {
  let response = await RNJudo.showPaymentMethods(
    Object.assign({}, judoOptions, applePayOptions, googlePayOptions, paymentOptions)
  );
  if (response.result === "Success") {
    //Handle successful result
  } else {
    //Handle non-success flow
  }
} catch (e) {
    //handle error
}

try {
  let response = await RNJudo.showPaymentMethods(
    Object.assign({}, judoOptions, applePayOptions, googlePayOptions, paymentOptions)
  );
  if (response.result === "Success") {
    //Handle successful result
  } else {
    //Handle non-success flow
  }
} catch (e) {
    //handle error
}

Transaction types: {
  RNJudo.APPLE_PAY_TRANSACTION_PAYMENT
  RNJudo.APPLE_PAY_TRANSACTION_PAYMENT
}

Shipping types: {
  RNJudo.APPLE_PAYMENT_SHIPPING
  RNJudo.APPLE_PAYMENT_DELIVERY
  RNJudo.APPLE_PAYMENT_STORE_PICKUP
  RNJudo.APPLE_PAYMENT_SERVICE_PICKUP
}

Apple Pay payment summary item types: {
  RNJudo.APPLE_PAYMENT_SUMMARY_FINAL
  RNJudo.APPLE_PAYMENT_SUMMARY_PENDING
}

Apple pay button light/dark styles: {
  RNJudo.APPLE_PAY_BUTTON_THEME_LIGHT
  RNJudo.APPLE_PAY_BUTTON_THEME_DARK
}

try {
  let response = await RNJudo.makeApplePayPayment(
    Object.assign({}, judoOptions, applePayOptions)
  );
  if (response.result === "Success") {
    //Handle successful result
  } else {
    //Handle non-success flow
  }
} catch (e) {
    //handle error
}

const googlePayOptions: JudoGooglePayOptions = {
  googlePayTestEnvironment: false,
  isPayment: false, // pre-auth
  isRequestBilling: false,
  isRequestContactDetails: false,
  isRequestShipping: false
};

try {
  let response = await RNJudo.makeGooglePayPayment(
    Object.assign({}, judoOptions, googlePayOptions)
  );
  if (response.result === "Success") {
    //Handle successful result
  } else {
    //Handle unsuccess flow
  }
} catch (e) {
    //handle error
}

For examples on how to integrate the SDK, see our sample app for more information.

Integration Requirements:

Integrate Judopay into your project by visiting the Xamarin component store:

var judo = new Judo()
{
    JudoId = "<JUDO_ID>",
    ApiToken = "<API_TOKEN>",
    ApiSecret = "<API_SECRET>",
    Environment = JudoEnvironment.Sandbox,
    Amount = 1.50m,
    Currency = "GBP",
    ConsumerReference = "YourUniqueReference"
};

Window.SetSoftInputMode(SoftInput.AdjustResize);

AndroidBugfix5497.assistActivity(this); 

DependencyService.Register<ClientService>();
DependencyService.Register<HttpClientHelper>();
// Required if using Apple Pay
DependencyService.Register<ApplePayService>();