Modify a session

Request

This endpoint allows updating session details after creation, including intent modification, amount updates, authentication decision, transaction decision, and 3DS external data.

Security

PXP-UST1

Path

sessionIdstring, (uuid)required

The unique identifier of the session to modify.

Bodyapplication/jsonrequired

transactionMethodobject

Details about the transaction method.

amountsobject

Details about the transaction amount.

addressVerificationobject

Details about the cardholder's address. These help in the validation and fraud prevention process by matching the provided address with the cardholder's address on file.

identityVerificationobject

Details about the cardholder's identity. These help in ensuring that the information provided matches the cardholder's details on file.

authenticationboolean

Whether or not to proceed with authentication.

Example:true

allowTransactionboolean or null

Whether the transaction is allowed to proceed. If not provided, defaults to null (no decision made yet).

Example:true

threeDSecureDataobject

Details about the 3D Secure authentication data from an external authentication process.

curl -i -X PATCH \
  'https://developer.pxp.io/_mock/apis/session/session-details/{sessionId}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "amounts": {
      "currencyCode": "EUR",
      "transactionValue": 20
    },
    "transactionMethod": {
      "intent": {
        "card": "EstimatedAuthorisation"
      }
    },
    "authentication": true,
    "allowTransaction": true,
    "threeDSecureData": {
      "threeDSecureVersion": "2.2",
      "electronicCommerceIndicator": "05",
      "cardHolderAuthenticationVerificationValue": "CAVV1234567890",
      "directoryServerTransactionId": "550e8400-e29b-41d4-a716-446655440000",
      "threeDSecureTransactionStatus": "Y"
    }
  }'

Responses

Session modified successfully

Response

No content

Modify a session

Request

Path

Responses

Was this helpful?