Skip to content

3D Secure and PSD2

Add 3D Secure data or a PSD2 SCA exemption to your transaction request.

Add 3D Secure data

To add 3D Secure (3DS) data to your transaction, you'll need to supply either an authentication ID or the authentication data.

Add the following snippet to the body of your request:

{
  "threeDSecureData": {
    "authenticationId": "550e8400-e29b-41d4-a716-446655440000"
  }
}
ParameterDescription
threeDSecureData
object
Details about the 3DS data.
threeDSecureData.authenticationId
string
required
A unique reference provided by PXP for the authentication request, represented as a GUID.

Add a PSD2 exemption

PSD2 requires that Strong Customer Authentication (SCA) is applied to all electronic payments including proximity and remote payments, within the European Economic Area (EEA) and the UK. However, you can request an exemption for certain types of transactions, such as low value transactions (under 50€).

To add an SCA exemption, add the following snippet to the body of your request.

{
  "psd2Data": {
    "scaExemption": "LowValue"
  }
}
ParameterDescription
psd2Data
object
Details about PSD2-related information for the transaction, including any applicable Strong Customer Authentication (SCA) exemptions.
psd2Data.scaExemption
string
required
The type of SCA exemption being requested for this transaction.

Possible values:
  • AnonymousCard
  • LowValue
  • SecureCorporate
  • TransactionRiskAnalysis
  • TrustedBeneficiary