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.

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
setupToken String Yes

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.
merchantAccount String Yes

The unique identifier of your merchant account.

store String No

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

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.