Tarjeta

Create card checkout session

post

Starts a new card checkout session for the payment.

This endpoint is available only for customer-initiated payments.

Autorizaciones

OAuth2ClientAuthentication

OpenID ConnectRequerido

This API uses OAuth 2 with the client credentials flow. More info

Parámetros de ruta

paymentIdstring · máx: 64Requerido

Unique ID of the payment

versionstringRequerido

Parámetros de encabezado

X-Request-Idstring · uuidRequerido

ID of the request, unique to the call, as determined by the initiating party

Cuerpo

application/json

Respuestas

200

OK

application/json

actionone ofOpcional

o

o

sessionIdstring · máx: 64Opcional

Unique ID of the checkout session

sessionStatusstring · enumOpcional

Status of the checkout session

Valores posibles:

400

Bad Request

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

503

Service Unavailable

application/json

post

/egw/{version}/payments/{paymentId}/sessions/card

HTTPcURLJavaScriptPython

POST /egw/{version}/payments/{paymentId}/sessions/card HTTP/1.1
Host: sandbox-api.ecomm.api.tietoevry.com
X-Request-Id: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 117

{
  "encryptedCard": {
    "jweCompact": "<header>.<encrypted key>.<initialization vector>.<ciphertext>.<authentication tag>"
  }
}

{
  "action": {
    "type": "AUTHENTICATE_WITH_3DS",
    "_links": {
      "checkoutRedirect": {
        "href": "text"
      },
      "threeDsMethod": {
        "href": "text"
      }
    }
  },
  "sessionId": "text",
  "sessionStatus": "INITIALIZED"
}

Get payment's checkout session

get

Get previously created checkout session

Autorizaciones

OAuth2ClientAuthentication

OpenID ConnectRequerido

This API uses OAuth 2 with the client credentials flow. More info

Parámetros de ruta

paymentIdstring · máx: 64Requerido

Unique ID of the payment

sessionIdstring · máx: 64Requerido

Unique ID of the checkout session

versionstringRequerido

Parámetros de encabezado

X-Request-Idstring · uuidRequerido

ID of the request, unique to the call, as determined by the initiating party

Respuestas

200

OK

application/json

actionone ofOpcional

o

o

sessionIdstring · máx: 64Opcional

Unique ID of the checkout session

sessionStatusstring · enumOpcional

Status of the checkout session

Valores posibles:

400

Bad Request

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

503

Service Unavailable

application/json

get

/egw/{version}/payments/{paymentId}/sessions/{sessionId}/card

HTTPcURLJavaScriptPython

GET /egw/{version}/payments/{paymentId}/sessions/{sessionId}/card HTTP/1.1
Host: sandbox-api.ecomm.api.tietoevry.com
X-Request-Id: 123e4567-e89b-12d3-a456-426614174000
Accept: */*

{
  "action": {
    "type": "AUTHENTICATE_WITH_3DS",
    "_links": {
      "checkoutRedirect": {
        "href": "text"
      },
      "threeDsMethod": {
        "href": "text"
      }
    }
  },
  "sessionId": "text",
  "sessionStatus": "INITIALIZED"
}

Initiate 3DS authentication

patch

Initiate 3DS authentication for the payment

Autorizaciones

OAuth2ClientAuthentication

OpenID ConnectRequerido

This API uses OAuth 2 with the client credentials flow. More info

Parámetros de ruta

paymentIdstring · máx: 64Requerido

Unique ID of the payment

sessionIdstring · máx: 64Requerido

Unique ID of the checkout session

versionstringRequerido

Parámetros de encabezado

X-Request-Idstring · uuidRequerido

ID of the request, unique to the call, as determined by the initiating party

Cuerpo

application/json

Request containing payment and 3DS browser data for 3DS authentication

browserAcceptHeaderstring · mín: 1Requerido

Exact content of the HTTP accept headers as sent to the 3DS Requestor from the Cardholder's browser

browserColorDepthstring · mín: 1Requerido

Value representing the bit depth of the colour palette for displaying images, in bits per pixel

browserIpstring · mín: 1Requerido

IP address of the browser as returned by the HTTP headers to the 3DS Requestor

browserJavaEnabledbooleanRequerido

Boolean that represents the ability of the cardholder browser to execute Java

browserJavascriptEnabledbooleanRequerido

Boolean that represents the ability of the cardholder browser to execute JavaScript

browserLanguagestring · mín: 1Requerido

Value representing the browser language as defined in IETF BCP47

browserScreenHeightstring · mín: 1Requerido

Total height of the Cardholder's screen in pixels

browserScreenWidthstring · mín: 1Requerido

Total width of the Cardholder's screen in pixels

browserTZstring · mín: 1Requerido

Time-zone offset in minutes between UTC and the Cardholder browser local time

browserUserAgentstring · mín: 1Requerido

Exact content of the HTTP user-agent header

Respuestas

200

OK

application/json

actionone ofOpcional

o

o

sessionIdstring · máx: 64Opcional

Unique ID of the checkout session

sessionStatusstring · enumOpcional

Status of the checkout session

Valores posibles:

400

Bad Request

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

503

Service Unavailable

application/json

patch

/egw/{version}/payments/{paymentId}/sessions/{sessionId}/card/three-ds/authentication

HTTPcURLJavaScriptPython

PATCH /egw/{version}/payments/{paymentId}/sessions/{sessionId}/card/three-ds/authentication HTTP/1.1
Host: sandbox-api.ecomm.api.tietoevry.com
X-Request-Id: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 261

{
  "browserAcceptHeader": "text",
  "browserColorDepth": "text",
  "browserIp": "text",
  "browserJavaEnabled": true,
  "browserJavascriptEnabled": true,
  "browserLanguage": "text",
  "browserScreenHeight": "text",
  "browserScreenWidth": "text",
  "browserTZ": "text",
  "browserUserAgent": "text"
}

{
  "action": {
    "type": "AUTHENTICATE_WITH_3DS",
    "_links": {
      "checkoutRedirect": {
        "href": "text"
      },
      "threeDsMethod": {
        "href": "text"
      }
    }
  },
  "sessionId": "text",
  "sessionStatus": "INITIALIZED"
}

Complete 3DS challenge

patch

Complete 3DS challenge for the payment

Autorizaciones

OAuth2ClientAuthentication

OpenID ConnectRequerido

This API uses OAuth 2 with the client credentials flow. More info

Parámetros de ruta

paymentIdstring · máx: 64Requerido

Unique ID of the payment

sessionIdstring · máx: 64Requerido

Unique ID of the checkout session

versionstringRequerido

Parámetros de encabezado

X-Request-Idstring · uuidRequerido

ID of the request, unique to the call, as determined by the initiating party

Cuerpo

application/json

Request to complete the 3DS challenge

cresstringRequerido

Base64-encoded CRes message, as received from the ACS

Respuestas

200

OK

application/json

sessionIdstring · máx: 64Opcional

Unique ID of the checkout session

sessionStatusstring · enumOpcional

Status of the checkout session

Valores posibles:

400

Bad Request

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

503

Service Unavailable

application/json

patch

/egw/{version}/payments/{paymentId}/sessions/{sessionId}/card/three-ds/challenge-result

HTTPcURLJavaScriptPython

PATCH /egw/{version}/payments/{paymentId}/sessions/{sessionId}/card/three-ds/challenge-result HTTP/1.1
Host: sandbox-api.ecomm.api.tietoevry.com
X-Request-Id: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "cres": "text"
}

{
  "action": {
    "type": "REDIRECT_TO_SHOP",
    "_links": {
      "shopRedirect": {
        "href": "text"
      }
    }
  },
  "sessionId": "text",
  "sessionStatus": "INITIALIZED"
}