Create account session with permissions for the specified embedded components.

Production Environment

https://api.lopay.com

POST

/api/1/partner/merchant/{id}/account-session

Request

Authorization

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Body Params application/json

Example

Create an account session

{
    "components": {
        "account_onboarding": {
            "enabled": true
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.lopay.com/api/1/partner/merchant//account-session' \
--header 'Content-Type: application/json' \
--header 'x-api-key;' \
--data-raw '{
    "components": {
        "account_onboarding": {
            "enabled": true
        }
    }
}'

Responses

🟢200OK

application/json

OK response

Body

Example

{
    "stripeAccountId": "acct_1NkDjjJyhOZfPCWt",
    "clientSecret": "_OXIKXxEihJokDBnDoe2sgG5OGSO2Q12shKvbeboxpALZGng",
    "expiresAt": "2025-01-01T00:00:00.000Z",
    "returnUrl": "https://merchant.lopay.app/xxx"
}

🟠401Unauthorized

🟠404Record Not Found

Modified at 2025-07-21 15:14:02

Get merchant onboarding link

Get list of available hardware for given merchant to purchase