Create Payment (3D Fingerprinting)
POST/payments/{payment-id}/fingerprint
Processes a payment request after the Device Fingerprinting step in the 3D payment flow.
Request
Path Parameters
Payment ID generated by REST API
Header Parameters
Idempotency Key for the request
- application/json
Body
required
Processing entityId
provided by Nuvei.
Values: Y = Merchant used fingerprinting | N = Merchant did not use fingerprinting | U = Merchant did not use fingerprinting due to technical reasons.
Possible values: [Y
, N
, U
]
Responses
- 201
- 400
- 401
- 403
- 500
OK
- application/json
- Schema
- Example (from schema)
- Approved Card 3D Challenge
- Successfully Authorized 3D payment – Frictionless Flow
Schema
2f00eba7-66ad-4d8b-8d54-b8c9183e664f
Nuvei Digital Payments Gateway Transaction ID
Possible values: <= 20 characters
The transaction ID of the transaction in the event that an external service is used.
Possible values: <= 50 characters
The transaction amount.
Determines the transaction type that is sent to the Gateway, when it comes to performing the fiscal transaction. Default is Sale.
Possible values: [Auth
, Sale
, PreAuth
, Settle
, Void
, Refund
, InitAuth3D
, Auth3D
, Sale3D
]
result
object
required
The authorization code of the transaction.
Possible values: <= 128 characters
The CVV2 (card verification value) response. Values: M = CVV2 Match | N = CVV2 No Match | P = Not Processed | U = Issuer is not certified and/or has not provided Visa the encryption keys | S = CVV2 processor is unavailable.
Possible values: <= 1 characters
The address verification service (AVS) response. Values: A = The street address matches, the ZIP code does not. | W = Postal code matches, the street address does not. | Y = Postal code and the street address match. | X = An exact match of both the 9-digit ZIP code and the street address. | Z = Postal code matches, the street code does not. | U = Issuer is unavailable. | S = AVS not supported by issuer. | R = Retry. | B = Not authorized (declined). | N = Both the street address and postal code do not match.
Possible values: <= 1 characters
partialApproval
object
providerResponseDetails
object
paymentOption
object
{
"paymentId": "2f00eba7-66ad-4d8b-8d54-b8c9183e664f",
"transactionId": "string",
"externalTransactionId": "string",
"amount": 0,
"currency": "string",
"transactionType": "Auth",
"result": {
"status": "approved",
"errors": {
"code": "7000.1000",
"reason": "Internal Processing Error"
}
},
"authCode": "string",
"cvv2Code": "string",
"avsCode": "string",
"partialApproval": {
"requestedAmount": 0,
"requestedCurrency": "string"
},
"providerResponseDetails": {
"code": "string",
"reason": "string"
},
"paymentOption": {
"card": {
"cardHolderName": "string",
"maskedCardNumber": "string",
"bin": "string",
"last4Digits": "string",
"expirationMonth": "string",
"expirationYear": "string",
"acquirerId": "string",
"cardType": "string",
"cardBrand": "string",
"paymentAccountReference": "string",
"paymentTokenId": "string",
"merchantReference": "12391284AF87C7D2",
"threeD": {
"version": "2.1.0",
"dsTransId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"acsUrl": "string",
"cReq": "string",
"acsTransId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"eci": "2",
"cavv": "string",
"whiteListStatus": "Y",
"acsChallengeMandate": "Y",
"authenticationType": "string",
"authenticationResult": "Y",
"flow": "Challenge",
"reasonId": "string",
"reason": "string",
"cardholderInfoText": "string",
"challengePreferenceReason": "string",
"acquirerDecision": "string",
"challengeCancelReason": "string",
"challengeCancelReasonId": "string",
"isLiabilityOnIssuer": true
}
}
}
}
Auth3D transaction Approved - 3DS Challenge Flow
{
"paymentId": "49900038994789921",
"transactionId": "2110000000011875918",
"amount": 74.8,
"currency": "USD",
"transactionType": "Auth3D",
"result": {
"status": "challenge"
},
"partialApproval": {
"requestedAmount": 74.8,
"requestedCurrency": "USD"
},
"paymentOption": {
"card": {
"cardHolderName": "John Doe",
"maskedCardNumber": "5***0008",
"bin": "554506",
"last4Digits": "0008",
"expirationMonth": "09",
"expirationYear": "28",
"acquirerId": "99",
"cardType": "Credit",
"cardBrand": "MASTERCARD",
"threeD": {
"dsTransId": "4f92a9ef-6196-4a89-a25c-97df99f835d0",
"acsUrl": "https://3dsn-qa.nuvei.com/api/ThreeDSACSChallengeController/ChallengePage?eyJub3RpZmljYXRpb25VUkwiOiJ3d3cuY2hhbGxlbmdlTm90aWZpY2F0aW9uLjI1NTEuY29tIiwidGhyZWVEU1NlcnZlclRyYW5zSUQiOiJmYjM2MzJhYi02NGQzLTQ2MjgtYmY1My1mMjE1ZDIzNWFiNzIiLCJhY3NUcmFuc0lEIjoiM2YxZTgxODAtMDQ0Yy00NTJjLWJhMmYtN2U0ZWI1NmEzZmM1IiwiZHNUcmFuc0lEIjoiNGY5MmE5ZWYtNjE5Ni00YTg5LWEyNWMtOTdkZjk5ZjgzNWQwIiwiZGF0YSI6bnVsbCwiTWVzc2FnZVZlcnNpb24iOiIyLjIuMCJ9",
"cReq": "eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6ImZiMzYzMmFiLTY0ZDMtNDYyOC1iZjUzLWYyMTVkMjM1YWI3MiIsImFjc1RyYW5zSUQiOiIzZjFlODE4MC0wNDRjLTQ1MmMtYmEyZi03ZTRlYjU2YTNmYzUiLCJjaGFsbGVuZ2VXaW5kb3dTaXplIjoiMDUiLCJtZXNzYWdlVHlwZSI6IkNSZXEiLCJtZXNzYWdlVmVyc2lvbiI6IjIuMi4wIn0",
"acsTransId": "3f1e8180-044c-452c-ba2f-7e4eb56a3fc5",
"version": "2.2.0",
"eci": "2",
"acsChallengeMandate": "Y",
"authenticationType": "01",
"authenticationResult": "C",
"flow": "Challenge",
"challengePreferenceReason": "NoPreference",
"acquirerDecision": "ExemptionRequest"
}
}
}
}
Successfully Authorized 3D Payment – Frictionless Flow
{
"paymentId": "49900038994789921",
"transactionId": "2110000000011875929",
"externalTransactionId": "211011875929",
"amount": 84.94,
"currency": "USD",
"transactionType": "Auth",
"result": {
"status": "authorizedOnly"
},
"authCode": "556180",
"partialApproval": {
"requestedAmount": 84.94,
"requestedCurrency": "USD"
},
"paymentOption": {
"card": {
"cardHolderName": "John Doe",
"maskedCardNumber": "5***0008",
"bin": "554506",
"last4Digits": "0008",
"expirationMonth": "08",
"expirationYear": "24",
"acquirerId": "99",
"cardType": "Credit",
"cardBrand": "MASTERCARD",
"threeD": {
"dsTransId": "ebc72fd5-20a1-4d95-83f3-cf8061747f2c",
"version": "2.2.0",
"eci": "2",
"cavv": "ejJRWG9SWWRpU2I1M21DelozSXU=",
"acsChallengeMandate": "Y",
"authenticationType": "01",
"authenticationResult": "C",
"flow": "Frictionless",
"challengePreferenceReason": "TransactionRiskAnalysis",
"acquirerDecision": "ExemptionRequest"
}
}
}
}
Bad Request
- application/json
- Schema
- Example (from schema)
Schema
2f00eba7-66ad-4d8b-8d54-b8c9183e664f
Nuvei Digital Payments Gateway Transaction ID
Possible values: <= 20 characters
The transaction ID of the transaction in the event that an external service is used.
Possible values: <= 50 characters
The transaction amount.
Determines the transaction type that is sent to the Gateway, when it comes to performing the fiscal transaction. Default is Sale.
Possible values: [Auth
, Sale
, PreAuth
, Settle
, Void
, Refund
, InitAuth3D
, Auth3D
, Sale3D
]
result
object
required
The authorization code of the transaction.
Possible values: <= 128 characters
The CVV2 (card verification value) response. Values: M = CVV2 Match | N = CVV2 No Match | P = Not Processed | U = Issuer is not certified and/or has not provided Visa the encryption keys | S = CVV2 processor is unavailable.
Possible values: <= 1 characters
The address verification service (AVS) response. Values: A = The street address matches, the ZIP code does not. | W = Postal code matches, the street address does not. | Y = Postal code and the street address match. | X = An exact match of both the 9-digit ZIP code and the street address. | Z = Postal code matches, the street code does not. | U = Issuer is unavailable. | S = AVS not supported by issuer. | R = Retry. | B = Not authorized (declined). | N = Both the street address and postal code do not match.
Possible values: <= 1 characters
partialApproval
object
providerResponseDetails
object
paymentOption
object
{
"paymentId": "2f00eba7-66ad-4d8b-8d54-b8c9183e664f",
"transactionId": "string",
"externalTransactionId": "string",
"amount": 0,
"currency": "string",
"transactionType": "Auth",
"result": {
"status": "approved",
"errors": {
"code": "7000.1000",
"reason": "Internal Processing Error"
}
},
"authCode": "string",
"cvv2Code": "string",
"avsCode": "string",
"partialApproval": {
"requestedAmount": 0,
"requestedCurrency": "string"
},
"providerResponseDetails": {
"code": "string",
"reason": "string"
},
"paymentOption": {
"card": {
"cardHolderName": "string",
"maskedCardNumber": "string",
"bin": "string",
"last4Digits": "string",
"expirationMonth": "string",
"expirationYear": "string",
"acquirerId": "string",
"cardType": "string",
"cardBrand": "string",
"paymentAccountReference": "string",
"paymentTokenId": "string",
"merchantReference": "12391284AF87C7D2",
"threeD": {
"version": "2.1.0",
"dsTransId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"acsUrl": "string",
"cReq": "string",
"acsTransId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"eci": "2",
"cavv": "string",
"whiteListStatus": "Y",
"acsChallengeMandate": "Y",
"authenticationType": "string",
"authenticationResult": "Y",
"flow": "Challenge",
"reasonId": "string",
"reason": "string",
"cardholderInfoText": "string",
"challengePreferenceReason": "string",
"acquirerDecision": "string",
"challengeCancelReason": "string",
"challengeCancelReasonId": "string",
"isLiabilityOnIssuer": true
}
}
}
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
2f00eba7-66ad-4d8b-8d54-b8c9183e664f
Nuvei Digital Payments Gateway Transaction ID
Possible values: <= 20 characters
The transaction ID of the transaction in the event that an external service is used.
Possible values: <= 50 characters
The transaction amount.
Determines the transaction type that is sent to the Gateway, when it comes to performing the fiscal transaction. Default is Sale.
Possible values: [Auth
, Sale
, PreAuth
, Settle
, Void
, Refund
, InitAuth3D
, Auth3D
, Sale3D
]
result
object
required
The authorization code of the transaction.
Possible values: <= 128 characters
The CVV2 (card verification value) response. Values: M = CVV2 Match | N = CVV2 No Match | P = Not Processed | U = Issuer is not certified and/or has not provided Visa the encryption keys | S = CVV2 processor is unavailable.
Possible values: <= 1 characters
The address verification service (AVS) response. Values: A = The street address matches, the ZIP code does not. | W = Postal code matches, the street address does not. | Y = Postal code and the street address match. | X = An exact match of both the 9-digit ZIP code and the street address. | Z = Postal code matches, the street code does not. | U = Issuer is unavailable. | S = AVS not supported by issuer. | R = Retry. | B = Not authorized (declined). | N = Both the street address and postal code do not match.
Possible values: <= 1 characters
partialApproval
object
providerResponseDetails
object
paymentOption
object
{
"paymentId": "2f00eba7-66ad-4d8b-8d54-b8c9183e664f",
"transactionId": "string",
"externalTransactionId": "string",
"amount": 0,
"currency": "string",
"transactionType": "Auth",
"result": {
"status": "approved",
"errors": {
"code": "7000.1000",
"reason": "Internal Processing Error"
}
},
"authCode": "string",
"cvv2Code": "string",
"avsCode": "string",
"partialApproval": {
"requestedAmount": 0,
"requestedCurrency": "string"
},
"providerResponseDetails": {
"code": "string",
"reason": "string"
},
"paymentOption": {
"card": {
"cardHolderName": "string",
"maskedCardNumber": "string",
"bin": "string",
"last4Digits": "string",
"expirationMonth": "string",
"expirationYear": "string",
"acquirerId": "string",
"cardType": "string",
"cardBrand": "string",
"paymentAccountReference": "string",
"paymentTokenId": "string",
"merchantReference": "12391284AF87C7D2",
"threeD": {
"version": "2.1.0",
"dsTransId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"acsUrl": "string",
"cReq": "string",
"acsTransId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"eci": "2",
"cavv": "string",
"whiteListStatus": "Y",
"acsChallengeMandate": "Y",
"authenticationType": "string",
"authenticationResult": "Y",
"flow": "Challenge",
"reasonId": "string",
"reason": "string",
"cardholderInfoText": "string",
"challengePreferenceReason": "string",
"acquirerDecision": "string",
"challengeCancelReason": "string",
"challengeCancelReasonId": "string",
"isLiabilityOnIssuer": true
}
}
}
}
Forbidden
- application/json
- Schema
- Example (from schema)
Schema
2f00eba7-66ad-4d8b-8d54-b8c9183e664f
Nuvei Digital Payments Gateway Transaction ID
Possible values: <= 20 characters
The transaction ID of the transaction in the event that an external service is used.
Possible values: <= 50 characters
The transaction amount.
Determines the transaction type that is sent to the Gateway, when it comes to performing the fiscal transaction. Default is Sale.
Possible values: [Auth
, Sale
, PreAuth
, Settle
, Void
, Refund
, InitAuth3D
, Auth3D
, Sale3D
]
result
object
required
The authorization code of the transaction.
Possible values: <= 128 characters
The CVV2 (card verification value) response. Values: M = CVV2 Match | N = CVV2 No Match | P = Not Processed | U = Issuer is not certified and/or has not provided Visa the encryption keys | S = CVV2 processor is unavailable.
Possible values: <= 1 characters
The address verification service (AVS) response. Values: A = The street address matches, the ZIP code does not. | W = Postal code matches, the street address does not. | Y = Postal code and the street address match. | X = An exact match of both the 9-digit ZIP code and the street address. | Z = Postal code matches, the street code does not. | U = Issuer is unavailable. | S = AVS not supported by issuer. | R = Retry. | B = Not authorized (declined). | N = Both the street address and postal code do not match.
Possible values: <= 1 characters
partialApproval
object
providerResponseDetails
object
paymentOption
object
{
"paymentId": "2f00eba7-66ad-4d8b-8d54-b8c9183e664f",
"transactionId": "string",
"externalTransactionId": "string",
"amount": 0,
"currency": "string",
"transactionType": "Auth",
"result": {
"status": "approved",
"errors": {
"code": "7000.1000",
"reason": "Internal Processing Error"
}
},
"authCode": "string",
"cvv2Code": "string",
"avsCode": "string",
"partialApproval": {
"requestedAmount": 0,
"requestedCurrency": "string"
},
"providerResponseDetails": {
"code": "string",
"reason": "string"
},
"paymentOption": {
"card": {
"cardHolderName": "string",
"maskedCardNumber": "string",
"bin": "string",
"last4Digits": "string",
"expirationMonth": "string",
"expirationYear": "string",
"acquirerId": "string",
"cardType": "string",
"cardBrand": "string",
"paymentAccountReference": "string",
"paymentTokenId": "string",
"merchantReference": "12391284AF87C7D2",
"threeD": {
"version": "2.1.0",
"dsTransId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"acsUrl": "string",
"cReq": "string",
"acsTransId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"eci": "2",
"cavv": "string",
"whiteListStatus": "Y",
"acsChallengeMandate": "Y",
"authenticationType": "string",
"authenticationResult": "Y",
"flow": "Challenge",
"reasonId": "string",
"reason": "string",
"cardholderInfoText": "string",
"challengePreferenceReason": "string",
"acquirerDecision": "string",
"challengeCancelReason": "string",
"challengeCancelReasonId": "string",
"isLiabilityOnIssuer": true
}
}
}
}
Internal Server Error
- application/json
- Schema
- Example (from schema)
Schema
2f00eba7-66ad-4d8b-8d54-b8c9183e664f
Nuvei Digital Payments Gateway Transaction ID
Possible values: <= 20 characters
The transaction ID of the transaction in the event that an external service is used.
Possible values: <= 50 characters
The transaction amount.
Determines the transaction type that is sent to the Gateway, when it comes to performing the fiscal transaction. Default is Sale.
Possible values: [Auth
, Sale
, PreAuth
, Settle
, Void
, Refund
, InitAuth3D
, Auth3D
, Sale3D
]
result
object
required
The authorization code of the transaction.
Possible values: <= 128 characters
The CVV2 (card verification value) response. Values: M = CVV2 Match | N = CVV2 No Match | P = Not Processed | U = Issuer is not certified and/or has not provided Visa the encryption keys | S = CVV2 processor is unavailable.
Possible values: <= 1 characters
The address verification service (AVS) response. Values: A = The street address matches, the ZIP code does not. | W = Postal code matches, the street address does not. | Y = Postal code and the street address match. | X = An exact match of both the 9-digit ZIP code and the street address. | Z = Postal code matches, the street code does not. | U = Issuer is unavailable. | S = AVS not supported by issuer. | R = Retry. | B = Not authorized (declined). | N = Both the street address and postal code do not match.
Possible values: <= 1 characters
partialApproval
object
providerResponseDetails
object
paymentOption
object
{
"paymentId": "2f00eba7-66ad-4d8b-8d54-b8c9183e664f",
"transactionId": "string",
"externalTransactionId": "string",
"amount": 0,
"currency": "string",
"transactionType": "Auth",
"result": {
"status": "approved",
"errors": {
"code": "7000.1000",
"reason": "Internal Processing Error"
}
},
"authCode": "string",
"cvv2Code": "string",
"avsCode": "string",
"partialApproval": {
"requestedAmount": 0,
"requestedCurrency": "string"
},
"providerResponseDetails": {
"code": "string",
"reason": "string"
},
"paymentOption": {
"card": {
"cardHolderName": "string",
"maskedCardNumber": "string",
"bin": "string",
"last4Digits": "string",
"expirationMonth": "string",
"expirationYear": "string",
"acquirerId": "string",
"cardType": "string",
"cardBrand": "string",
"paymentAccountReference": "string",
"paymentTokenId": "string",
"merchantReference": "12391284AF87C7D2",
"threeD": {
"version": "2.1.0",
"dsTransId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"acsUrl": "string",
"cReq": "string",
"acsTransId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"eci": "2",
"cavv": "string",
"whiteListStatus": "Y",
"acsChallengeMandate": "Y",
"authenticationType": "string",
"authenticationResult": "Y",
"flow": "Challenge",
"reasonId": "string",
"reason": "string",
"cardholderInfoText": "string",
"challengePreferenceReason": "string",
"acquirerDecision": "string",
"challengeCancelReason": "string",
"challengeCancelReasonId": "string",
"isLiabilityOnIssuer": true
}
}
}
}
Authorization: http
name: accessTokentype: httpscheme: bearerbearerFormat: JWT
- curl
- CURL
curl -L 'https://api-sandbox.nuvei.com/payment-api/payments/:payment-id/fingerprint' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
"processingEntityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"fingerprintingIndicator": "Y"
}'