3DS Challenge
Verify authentication challenge
Methods
POST
Request
Copied!
{
"type": "object",
"required": [
"challengeReference"
],
"properties": {
"challengeReference": {
"type": "string"
}
}
}{ "type": "object", "required": [ "challengeReference" ], "properties": { "challengeReference": { "type": "string" } } }
Responses
Response schema
Copied!
{
"type": "object",
"properties": {
"3ds": {
"type": "object",
"properties": {
"issuerResponse": {
"type": "string"
},
"outcome": {
"type": "string"
}
}
},
"code": {
"type": "string"
},
"riskFactors": {
"type": "array"
},
"transactionReference": {
"type": "string"
},
"_links": {
"type": "array"
},
"fraud": {
"type": "object",
"properties": {
"score": {
"type": "number"
},
"outcome": {
"type": "string"
}
}
},
"description": {
"type": "string"
},
"outcome": {
"type": "string"
},
"authentication": {
"type": "object",
"properties": {
"eci": {
"type": "string"
},
"type": {
"type": "string"
},
"version": {
"type": "string"
},
"authenticationValue": {
"type": "string"
},
"transactionId": {
"type": "string"
}
}
}
}
}{ "type": "object", "properties": { "3ds": { "type": "object", "properties": { "issuerResponse": { "type": "string" }, "outcome": { "type": "string" } } }, "code": { "type": "string" }, "riskFactors": { "type": "array" }, "transactionReference": { "type": "string" }, "_links": { "type": "array" }, "fraud": { "type": "object", "properties": { "score": { "type": "number" }, "outcome": { "type": "string" } } }, "description": { "type": "string" }, "outcome": { "type": "string" }, "authentication": { "type": "object", "properties": { "eci": { "type": "string" }, "type": { "type": "string" }, "version": { "type": "string" }, "authenticationValue": { "type": "string" }, "transactionId": { "type": "string" } } } } }
Examples
Example of 3dsChallenge
POSTverifiedPayments:3dsChallenge HATEAOAS link from 3dsDeviceData response (if 3dsChallenged)
Copied!
{
"Authorization": "Bearer token",
"Accept": "application/vnd.worldpay.verifiedpayments-v1.hal+json",
"Content-Type": "application/vnd.worldpay.verifiedpayments-v1.hal+json"
}{ "Authorization": "Bearer token", "Accept": "application/vnd.worldpay.verifiedpayments-v1.hal+json", "Content-Type": "application/vnd.worldpay.verifiedpayments-v1.hal+json" }
Copied!
{
"challengeReference": "123456789"
}{ "challengeReference": "123456789" }
202
Copied!
{
"outcome": "sentForSettlement",
"transactionReference": "116111",
"_links": {
"payments:refund": {
"href": "http://payments-simulator:8082/payments/settlements/refunds/full/eyJrIjoiazNhYjYzMiJ9"
},
"payments:partialRefund": {
"href": "http://payments-simulator:8082/payments/settlements/refunds/partials/eyJrIjoiazNhYjYzMiJ9"
},
"payments:events": {
"href": "http://payments-simulator:8082/payments/events/eyJrIjoiazNhYjYzMiJ9"
},
"curies": [
{
"href": "http://payments-simulator:8082/rels/payments/{rel}",
"name": "payments",
"templated": true
}
]
}
}{ "outcome": "sentForSettlement", "transactionReference": "116111", "_links": { "payments:refund": { "href": "http://payments-simulator:8082/payments/settlements/refunds/full/eyJrIjoiazNhYjYzMiJ9" }, "payments:partialRefund": { "href": "http://payments-simulator:8082/payments/settlements/refunds/partials/eyJrIjoiazNhYjYzMiJ9" }, "payments:events": { "href": "http://payments-simulator:8082/payments/events/eyJrIjoiazNhYjYzMiJ9" }, "curies": [ { "href": "http://payments-simulator:8082/rels/payments/{rel}", "name": "payments", "templated": true } ] } }
