Web
...
Web SDK
CheckCard Request
creating a checkcard request with the web sdk the web sdk’s check card functionality can be used to perform a zero amount pre authorisation (0 auth) check card enables you to check the validity of the card, to be used for future payments 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 request docid\ vool6a4nsy9s0gyjpmbst functionality 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 web sdk docid 40dwe6lbub7vdkza1qydc you do not need to include the amount or currency fields in your request body web sdk docid 40dwe6lbub7vdkza1qydc step one making a check card request define the checkcardconfiguration object ensure the details used when creating the paymentsession match the values set in the checkcardconfiguration object check card configuration object const checkcardconfiguration = { judoid "yourjudoid", 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", } see below for more details on the parameters that create the checkcardconfiguration object true false 254false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type 2\ in a function, add the invokecheckcard call this will make check card request using both the paymentsession and checkcardconfiguration invoke check card call function handlecheckcardbuttonclick() { judo invokecheckcard(paymentsession, checkcardconfiguration) then(handlesuccess) catch(handleerror) } 3\ to call the invokecheckcard function (in step 2 above) to make the check card request, add the onclick attribute to the payment button \<div> \<button id="submit payment button" onclick="handlecheckcardbuttonclick()"> check 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 check card instead of pay now step two handle the response all the judopay web sdk transaction methods return a promise once the authorisation is complete, the promise will be either fulfilled or rejected fulfilled you will receive a json object response (a judopay receipt object) for more information and schema on the json object, see transaction api reference docid\ bcxnm5keok nlnrztafut 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 payment form error messages docid\ qfxawpaql 2evfp8y94d the consumer should be redirected to an error page response example const onfulfillment = (receiptobject) => { const { result } = receiptobject //redirect to appropriate page depending on the result (success/failure/declined page) } const onrejection = (error) => { //redirect to error page and handle error } for more information on the response codes, see codes and descriptions docid zrsihomuew xnrq4pbtj