SaveCard Request

Creating a SaveCard Request with the Web SDK
If you do not want to perform a pre-authorisation check on a customer's account, use this call to tokenise the card information into an encrypted string.
Do you have a stored card wallet for existing customers?
If validation is successful, a card token is returned as part of the response object.
This token can then be stored and used for a payments / preauths request in the future, using the Web SDK’s  Token Payment﻿ functionality.
Prerequisites
Make sure you are using Web SDK Version 0.0.43 (or higher).
Make sure you have implemented the following:
From the Web SDK integration guide, you have completed the following:
﻿Step One: Create a paymentSession﻿﻿
You do not need to include the amount or currency fields in your request body.
﻿Step Two: Add the Payment Form to your Website﻿﻿
﻿
Step One: Making a Save Card Request
Define the saveCardConfiguration object.
Ensure the details used when creating the paymentSession match the values set in the saveCardConfiguration object.
Save Card Configuration Object
const saveCardConfiguration = {
    judoId: "yourJudoId",
    yourConsumerReference: "yourConsumerReference",
    currency: "GBP"
    billingAddress: {
        address1: "My house",
        address2: "My street",
        town: "My town",
        state: "My state", //Mandatory for US and Canada
        postCode: "TR14 8PA",
        cardHolderName: "Consumer Name",
        country: "826"
    }
}
const saveCardConfiguration = {
    judoId: "yourJudoId",
    yourConsumerReference: "yourConsumerReference",
    currency: "GBP"
    billingAddress: {
        address1: "My house",
        address2: "My street",
        town: "My town",
        state: "My state", //Mandatory for US and Canada
        postCode: "TR14 8PA",
        cardHolderName: "Consumer Name",
        country: "826"
    }
}
﻿
See below for more details on the parameters that create the saveCardConfiguration object:
Parameter
Description
judoId
String
Required﻿
Unique ID supplied by Judopay.
Specific to a merchant and/or location.
Format:
100100100
Maximum length 9 characters.
Do not include spaces or dashes.
yourConsumerReference
String
Required﻿
Unique reference to anonymously identify your customer.
Advisable to use GUIDs.
Must be below 40 characters.
currency
String
Optional﻿
﻿
﻿
The currency of the transaction.
Any ISO 4217 alphabetic currency code:
GBP
USD
EUR
cardHolderName
String
Optional﻿
The card name of the consumer
If the cardHolderName field is displayed to the user in the payment form (isCardHolderNameVisible: true is set in the iFrame config), the value entered in the payment form will overwrite this value.
billingAddress
Object
Optional﻿
﻿
﻿
Card holder's billing address.
Properties:
address1
address2 (optional)
town
state(only required if country is USA/Canada)
Format:
string
ISO Alpha-2 Code (e.g. California = "CA")
country
Format:
string
See here﻿ for the list of valid ISO 3166-1 format country codes.
postCode
If the billingAddress is provided, the postcode is required.
    2.  In a function, add the invokeSaveCard call.
    This will make a Save Card request using the paymentSession and
    saveCardConfiguration.
Invoke Save Card Call
function handleSaveCardButtonClick() {
    judo.invokeSaveCard(paymentSession, saveCardConfiguration)
    .then(handleSuccess)
    .catch(handleError)
}
function handleSaveCardButtonClick() {
    judo.invokeSaveCard(paymentSession, saveCardConfiguration)
    .then(handleSuccess)
    .catch(handleError)
}
﻿
    3. To call the invokeSaveCard function (in step 2 above) to make the Save Card request,   
    add the onclick attribute to the payment button <div>:
    <button id="submit-payment-button" onclick="handleSaveCardButtonClick()"> Save Card</button>
This is the same button that is used for payments, however you can update the button label to reflect it’s functionality. For example: Save Card instead of Pay Now.
﻿
Step Two: Handle the Response
Once the Save Card request is complete you will receive either:
Fulfilled
You will receive a JSON object response (a Judopay receipt object).
For more information and schema on the JSON object, see API Transaction Response.
Depending on the result the consumer should be redirected to the appropriate outcome page.
For example, if the result = SUCCESS redirect the consumer to the Success Page.
This page should display the necessary transaction information (found in the Judopay receipt object).
Rejected
You will receive an error object
For more information on error responses returned, see Web SDK Error Responses﻿.
The consumer should be redirected to an Error Page.
Save Card Response Example
const handleSuccess = (response) => {
  //If the save card request was successful:
  //If the result value in the response object is 'Success', you could store the card token.
  //The card token can be used in the future for Token Payments
}
const handleError = (error) => {
  //Inform the user that their card could not be saved.
}
const handleSuccess = (response) => {
  //If the save card request was successful:
  //If the result value in the response object is 'Success', you could store the card token.
  //The card token can be used in the future for Token Payments
}
const handleError = (error) => {
  //Inform the user that their card could not be saved.
}
﻿
For more information on the response codes, see Codes﻿.
﻿
﻿

Parameter	Description
judoId String Required	Unique ID supplied by Judopay. Specific to a merchant and/or location. Format: 100100100 Maximum length 9 characters. Do not include spaces or dashes.
yourConsumerReference String Required	Unique reference to anonymously identify your customer. Advisable to use GUIDs. Must be below 40 characters.
currency String Optional	The currency of the transaction. Any ISO 4217 alphabetic currency code: GBP USD EUR
cardHolderName String Optional	The card name of the consumer If the cardHolderName field is displayed to the user in the payment form (isCardHolderNameVisible: true is set in the iFrame config), the value entered in the payment form will overwrite this value.
billingAddress Object Optional	Card holder's billing address. Properties: address1 address2 (optional) town state(only required if country is USA/Canada) Format: string ISO Alpha-2 Code (e.g. California = "CA") country Format: string See here for the list of valid ISO 3166-1 format country codes. postCode If the billingAddress is provided, the postcode is required.

CheckCard Request

Token Payment Request