POST
The 3DS Requestor uses card number to initiate 3DS Method processing with 3DSS. This is being done by calling D8 3DSS method /api/3dsmethod with accountNumber field in request body.
Checks the card eligibility.
| Name | Pattern | Mandatory | Description |
|---|---|---|---|
| acctNumber | Length: Variable, 13–19 characters JSON Data Type: String Value accepted: Format represented ISO 7812 |
Mandatory | Account (card) number that will be used in the authorization request for payment transactions |
| Name | Pattern | Mandatory | Description |
|---|---|---|---|
| protocolVersion | Length: Variable, 5–8 characters JSON Data Type: String |
Mandatory | The most recent active protocol version that is supported for the ACS URL |
| threeDSMethodData | JSON array | Mandatory | The data is exchanged between the 3DS Requestor via the cardholder browser |
| threeDSServerTransID | Length: 36 characters ; JSON Data Type: String Value accepted: Canonical format as defined in IETF RFC 4122. May utilise any of the specified versions if the output meets specified requirements |
Mandatory | A unique identifier for the transaction that will be the same as the 3DS Server Transaction ID in the AReq |
| threeDSMethodNotificationURL | Length: Variable, maximum 2048 characters JSON Data Type: String Value accepted: Fully qualified URL |
Mandatory | The URL that will receive the notification of 3DS Method completion from the ACS. This is sent in the initial request to the ACS from the 3DS Requestor executing the 3DS Method. |
| methodUrl | Length: Variable, Maximum 256 characters JSON Data Type: String Value accepted: Fully qualified URL |
Optional | The ACS URL that will be used by the 3DS Method Note: The methodUrl data element may be omitted if not supported by the ACS for this specific card range |
{
"acctNumber": "5500300104000003"
}
{
"protocolVersion": "2.1.0",
"methodUrl": "https://acs.vendorcert.com/ds/6300",
"threeDSMethodData": {
"threeDSServerTransID": "6e8b3d3a-1dc1-4dbf-b787-59daad31b059",
"threeDSMethodNotificationURL": "https://3dss-test.com/threedsmethodnotification/6e8b3d3a-1dc1-4dbf-b787-59daad31b059"
}
}