Skip to main content
POST
/
v1
/
authenticate
/
{customerNumber}
/
{sessionId}
OOB Webhook Notification
curl --request POST \
  --url https://integration-api-cat2.demo.ext.test.cia.enfuce.com/enfuceid/api/v1/authenticate/{customerNumber}/{sessionId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "callbackUrl": "https://id.enfuce.com/v1/callback/mycompany/392492402/5d3a3e10-b511-42cd-b9b6-1f2a5701ba98",
  "transaction": {
    "type": "PAYMENT",
    "cardId": "<string>",
    "cardNumber": "342170______9554",
    "timestamp": "<string>",
    "amount": {
      "amount": 3.14,
      "currency": "EUR"
    }
  },
  "merchant": {
    "description": "Airline ticket",
    "name": "Airline of the world inc.",
    "country": "FIN",
    "url": "https://www.airline.com/order/64674"
  }
}
'
{
  "code": "<string>",
  "message": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "errorCode": "<string>",
  "errorType": "STATIC_VALIDATION_ERROR",
  "errorReason": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
customerNumber
string
required

Unique identifier of the cardholder

​
sessionId
string
required

Unique identification number of the ensuing authentication request, returned in the callback request after the authentication request is complete.

Body

application/json

Extra information in order to give information about why authentication is initiated

​
callbackUrl
string
required

URL where the authentication result is forwarded.

Example:

"https://id.enfuce.com/v1/callback/mycompany/392492402/5d3a3e10-b511-42cd-b9b6-1f2a5701ba98"

​
transaction
object
​
merchant
object

Response

Successful initiation of authentication