Results for

icon-search-large No search results yet
Enter your search query above

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",
     	"threeDServerTransactionId" : "8ecb21db-a7a5-4b18-853a-32128ef9f430"
		}
    }
  },
  "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
      }
   }
}   

Additional information

  1. Introduction
  2. Highlevel implementation
  3. Consumer user experience
  4. MyCheckout hosted payment pages implementation
  5. Create Payment API implementation
  6. Test cases
  7. Special use cases
  8. Webhooks