Judopay Documentation

Change Logs

Learn about the latest updates to our API:

February 2021

1st February

New

API version 6.1

API Version 6.1 released to support the new payment methods added to Judopay's Hosted Payments Page:

  • POST /webpayments/checkcard

    • Verify your consumer's card without reserving funds on their account.

    • Performs a zero amount pre-authorisation (0 Auth).

    • Supported for Web Payments - Version 2.

Enhancement

  • Maestro Cards For calls to:  

    • POST /transactions/payments   

    • POST /transactions/preauths

      the startDate parameter is no longer mandatory for Maestro cards.

January 2021

19th January

New:

API Version 6.0

  • API Version 6.0 released to advertise support for payment requests using 3DSecure 2 authentication.

  • For 3DSecure 2, new attributes are required on:

    • POST

      /transactions/payments

    • POST

      /transactions/preauths

    {
     ...
     "cardHolderName": "John Doe",
     "mobileNumber": "07999999999",
     "emailAddress": "example@domain.com"
     "threeDSecure": {
       "authenticationSource": "BROWSER",
       "methodNotificationUrl": "https://api.judopay.com/order/3ds/methodNotification",
       "challengeNotificationUrl": "https://api.judopay.com/order/3ds/challengeNotification",
       "methodCompletion": "No"
     }
    }
    
  • After the device details check:

    • PUT

      /transactions/{receiptid}/resume3ds

    {
     "cV2": "xxx",
     "threeDSecure": {
       "methodCompletion": "Yes",
     }
    }
    
  • After the challenge is completed:

    • PUT

      /transactions/{receiptid}/complete3ds

  • Using 3DSecure 2 in Sandbox (non production) environments, a GlobalPayments test card will be selected for authentication using the supplied CardHolderName:

    || CardHolderName || Test Card Number || Transaction Result ||
    | FL-SUCCESS | 4263970000005262 | AUTHENTICATION_SUCCESSFUL |
    | FL-ATTEMPT-NO-SUCCESS | 4012001037167778 | AUTHENTICATION_ATTEMPTED_BUT_NOT_SUCCESSFUL |
    | FL-FAILED | 4012001037461114 | AUTHENTICATION_FAILED |
    | FL-ISSUER-REJECTED | 4012001038443335 | AUTHENTICATION_ISSUER_REJECTED |
    | FL-AUTH-ERROR | 4012001037484447 | AUTHENTICATION_COULD_NOT_BE_PERFORMED |
    | CHALLENGE | 4012001038488884 | CHALLENGE_REQUIRED |
    

    See, Verify your 3D Secure 2 Integration.