Challenge 3DSv2 Card

post {protocol}://{domain}/helpdesk/payment/plans/3dscardchallenge

POST request for completing the challenge flow for a 3DSv2 Card - Payment Plans and Arrangements.
Whether Payment Plan or Arrangement is used is decided based on config.
Note that the request body for an Arrangement challenge is different to that of a payment plan challenge (see examples).

Query Params

reference

integer

Reference number of account to save card to while logged out, if x-access-token is sent, this is ignored

token

string

Reference uuid for paymentToken

Body Params

The body to complete the challenge flow for a 3DSv2 Card. Note that payment plans require paymentPlanLUUID, whereas arrangements do not

cres

string

required

Required. Challenge Request Encoded String for 3DSv2 authentication.

originalTransactionId

string

required

Required. Original transaction ID for referencing the challenge.

cardDetails

object

required

Schema for providing card and associated address details.

paymentPlanLUUID

string

Optional. Required only if the challenge is for a payment plan.

date

string

required

Required. Date for the payment plan, formatted as YYYY-MM-DD.

frequency

string

required

Required. Frequency of the payment

amount

number

required

Required. Amount for the payment plan.

firstName

string

required

Required. First name of the cardholder.

lastName

string

required

Required. Last name of the cardholder.

dob

string

required

Required. Date of birth of the cardholder, formatted as YYYY-MM-DD.

string

required

Required. Email address of the cardholder.

browserData

object

required

Browser-related data for the transaction.

notificationUrl

string

required

Required. URL where transaction notifications will be sent.

contactUrl

string

required

Required. URL for contacting the merchant.

requestChallenge

boolean

Optional. Whether a 3D Secure challenge should be requested.

Responses

Language

Credentials

URL


xxxxxxxxxx
1
curl --request POST \
2
     --url https://public.glabs.financial-cloud.co.uk/helpdesk/payment/plans/3dscardchallenge \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "frequency": "monthly"
8
}
9
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

2013DSv2 Card Challenge Flow successfully completed

400There was an error completing the 3DSv2 Card Challenge

500Internal Server Error