Special use cases
Using externally obtained authentication results
It is possble to submit external authentication results for both 3-D Secure version 1 and version 2 in your create Payment request. We'll then not perform an authentication, but we will use the data submitted by you directly in our authorization process.
Examples
Create Payment request - External authentication 3-D Secure version 1
POST /v1/70417/payments HTTP/1.1
Authorization: GCS v1HMAC:2852fe598a84c2d8:Ch9sCYPdtpEh5BQKj08RoHXfTMPDg2uxaenyQBTOpV8=
Date: Mon, 08 Jul 2019 23:32:15 GMT
Content-Type: application/json
Host: 10.63.66.100:20104
Connection: close
User-Agent: Paw/3.1.8 (Macintosh; OS X/10.14.5) GCDHTTPRequest
Content-Length: 881
{
"cardPaymentMethodSpecificInput": {
"card": {
"cvv": "451",
"cardNumber": "4012005616165343",
"expiryDate": "1220",
"cardholderName": "Wile E. Coyote"
},
"isRecurring": false,
"paymentProductId": 1,
"transactionChannel": "ECOMMERCE",
"threeDSecure": {
"externalCardholderAuthenticationData": {
"cavv": "AAABBEg0VhI0VniQEjRWAAAAAAA=",
"eci": "05",
"xid": "000007041700000006220000100001"
}
}
},
"order": {
"amountOfMoney": {
"currencyCode": "EUR",
"amount": 2980
},
"customer": {
"billingAddress": {
"countryCode": "NL"
}
},
"references": {
"merchantOrderId": 123456,
"merchantReference": "WLSmESDvuf3jtOHCO0f3cAJgPBcbJI"
}
}
} Create Payment response - External authentication 3-D Secure version 1
{
"creationOutput" : {
"additionalReference" : "rohEA0gCrF60HubT3TWP",
"externalReference" : "rohEA0gCrF60HubT3TWPiS4pjAx50R"
},
"payment" : {
"id" : "000007041700000008250000100001",
"paymentOutput" : {
"amountOfMoney" : {
"amount" : 2980,
"currencyCode" : "EUR"
},
"references" : {
"merchantOrderId" : 123456,
"merchantReference" : "rohEA0gCrF60HubT3TWPiS4pjAx50R",
"paymentReference" : "0"
},
"paymentMethod" : "card",
"cardPaymentMethodSpecificOutput" : {
"paymentProductId" : 1,
"fraudResults" : {
"fraudServiceResult" : "no-advice",
"avsResult" : "0",
"cvvResult" : "0"
},
"threeDSecureResults" : {
"cavv" : "AAABBEg0VhI0VniQEjRWAAAAAAA=",
"eci" : "5",
"xid" : "000007041700000006220000100001"
},
"card" : {
"cardNumber" : "************5343",
"expiryDate" : "1220"
}
}
},
"status" : "PENDING_APPROVAL",
"statusOutput" : {
"isCancellable" : true,
"statusCategory" : "PENDING_MERCHANT",
"statusCode" : 600,
"statusCodeChangeDateTime" : "20190708212550",
"isAuthorized" : true,
"isRefundable" : false
}
}
} Create Payment request - External authentication 3-D Secure version 2
POST /v1/70417/payments HTTP/1.1
Authorization: GCS v1HMAC:2852fe598a84c2d8:EJX8ONPhufbSORaA6CwIylgzkxxaRNd/JUael7wEI7k=
Date: Mon, 08 Jul 2019 23:30:33 GMT
Content-Type: application/json
Host: 10.63.66.100:20104
Connection: close
User-Agent: Paw/3.1.8 (Macintosh; OS X/10.14.5) GCDHTTPRequest
Content-Length: 1028
{
"cardPaymentMethodSpecificInput": {
"card": {
"cvv": "451",
"cardNumber": "4012005616165343",
"expiryDate": "1220",
"cardholderName": "Wile E. Coyote"
},
"isRecurring": false,
"paymentProductId": 1,
"transactionChannel": "ECOMMERCE",
"threeDSecure": {
"externalCardholderAuthenticationData": {
"cavv" : "AAABBEg0VhI0VniQEjRWAAAAAAA=",
"directoryServerTransactionId" : "f25084f0-5b16-4c0a-ae5d-b24808a95e4b",
"eci" : "05",
"threeDSecureVersion" : "2.1.0"
}
}
},
"order": {
"amountOfMoney": {
"currencyCode": "EUR",
"amount": 2980
},
"customer": {
"billingAddress": {
"countryCode": "NL"
}
},
"references": {
"merchantOrderId": 123456,
"merchantReference": "oGPc8xJURfpFitBa6ORrpkBuPoGpvD"
}
}
} Create Payment response - External authentication 3-D Secure version 2
HTTP/1.1 201
Location: http://10.63.66.100:20104/v1/70417/payments/000007041700000008210000100001
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Mon, 08 Jul 2019 19:50:58 GMT
Connection: close
{
"creationOutput" : {
"additionalReference" : "VjM0O0U7BOE3brdOK0Ec",
"externalReference" : "VjM0O0U7BOE3brdOK0Ecik4VAuJlUJ"
},
"payment" : {
"id" : "000007041700000008210000100001",
"paymentOutput" : {
"amountOfMoney" : {
"amount" : 2980,
"currencyCode" : "EUR"
},
"references" : {
"merchantOrderId" : 123456,
"merchantReference" : "VjM0O0U7BOE3brdOK0Ecik4VAuJlUJ",
"paymentReference" : "0"
},
"paymentMethod" : "card",
"cardPaymentMethodSpecificOutput" : {
"paymentProductId" : 1,
"fraudResults" : {
"fraudServiceResult" : "no-advice",
"avsResult" : "0",
"cvvResult" : "0"
},
"threeDSecureResults" : {
"cavv" : "AAABBEg0VhI0VniQEjRWAAAAAAA=",
"eci" : "05",
"threeDSecureVersion" : "2.1.0"
},
"card" : {
"cardNumber" : "************5343",
"expiryDate" : "1220"
}
}
},
"status" : "PENDING_APPROVAL",
"statusOutput" : {
"isCancellable" : true,
"statusCategory" : "PENDING_MERCHANT",
"statusCode" : 600,
"statusCodeChangeDateTime" : "20190708195058",
"isAuthorized" : true,
"isRefundable" : false
}
}
}