Create a communication session

post/sessions

Establishes a secure communications session between the POS Mobile SDK and the Adyen payments platform, through mutual authentication. The request sends a setup token that identifies the SDK and the device. The response returns a session token that the SDK can use to authenticate responses received from the Adyen payments platform.

This request applies to mobile in-person transactions. You cannot use this request to create online payments sessions.

Endpoint destination URL
https://checkout-test.adyen.com/checkout/possdk/v68/sessions
Click to copy

Request Parameters

merchantAccountstringRequired

The unique identifier of your merchant account.

setupTokenstringRequired
Max length: 50000

The setup token provided by the POS Mobile SDK.

  • When using the Android POS Mobile SDK, obtain the token through the AuthenticationService.authenticate(setupToken) callback of AuthenticationService.
  • When using the iOS POS Mobile SDK, obtain the token through the PaymentServiceDelegate.register(with:) callback of PaymentServiceDelegate.
storestring

The unique identifier of the store that you want to process transactions for.

Response parameters

After submitting a call, you receive a response message to inform you that your request was received and processed.

Depending on the HTTP status code of the response message, it is helpful to build some logic to handle any errors that a request or the system may return.

HTTP Responses

  • 201 - Created

    The request has been fulfilled and has resulted in one or more new resources being created.

    Show moreShow less