Payment Request

Creating a Payment / PreAuth Request with the Web SDK
When authorising /payments or /preauths it is recommended to use paymentSession.
Prerequisites
Make sure you are using Web SDK Version 0.0.34 (or higher).
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 Transaction
To make a transaction:
Define the paymentConfiguration object for the payment or preAuth:
Ensure the details used when creating the paymentSession match the values set in the following configuration:
Payment Configuration Object Example
const paymentConfiguration = {
    judoId: "yourJudoId",
    amount: 1.01,
    currency: "GBP",
    phoneCountryCode: "44",
    challengeRequestIndicator: "challengeAsMandate",
    initialRecurringPayment: false,
    yourConsumerReference: "yourConsumerReference",
    yourPaymentReference: "yourPaymentReference",
    billingAddress: {
        address1: "My house",
        address2: "My street",
        town: "My town",
        state: "My state", //Mandatory for US and Canada
        postCode: "TR14 8PA",
        country: "826"
    },
    mobileNumber: "07999999999",
    emailAddress: "[email protected]",
    primaryAccountDetails: {
        name: "Doe",
        accountNumber: "9999999",
        dateOfBirth: "1989-09-19",
        postCode: "AB1 2CD"
    }
}

const paymentConfiguration = {
    judoId: "yourJudoId",
    amount: 1.01,
    currency: "GBP",
    phoneCountryCode: "44",
    challengeRequestIndicator: "challengeAsMandate",
    initialRecurringPayment: false,
    yourConsumerReference: "yourConsumerReference",
    yourPaymentReference: "yourPaymentReference",
    billingAddress: {
        address1: "My house",
        address2: "My street",
        town: "My town",
        state: "My state", //Mandatory for US and Canada
        postCode: "TR14 8PA",
        country: "826"
    },
    mobileNumber: "07999999999",
    emailAddress: "contact@judopay.com",
    primaryAccountDetails: {
        name: "Doe",
        accountNumber: "9999999",
        dateOfBirth: "1989-09-19",
        postCode: "AB1 2CD"
    }
}
﻿
﻿
Web SDK Payment Parameter Descriptions
See below for more details on the parameters that create the paymentConfiguration object:
﻿
2. In a function, add the invokePaymentcall.
This will invoke a payment using the paymentSession and paymentConfiguration
Invoke Payment Example
function handlePaymentButtonClick() {
    judo.invokePayment(paymentSession, paymentConfiguration)
    .then(handleSuccess)
    .catch(handleError)
}
function handlePaymentButtonClick() {
    judo.invokePayment(paymentSession, paymentConfiguration)
    .then(handleSuccess)
    .catch(handleError)
}
﻿
To invoke a preAuth, change the above code to .invokePreauth
3. To call the function (in step 2 above) to invoke the payment or preAuth, add the onclickattribute to the payment button <div>:
<button id="submit-payment-button" onclick="handlePaymentButtonClick()"> Pay Now </button>
﻿
Step Two: Handle the Response
﻿
﻿
Updated 29 Nov 2024
Web SDK
CheckCard Request