Delegate

Add a delegate

A delegate is a person, authenticated by BankID and associated with a unique PSU. Read more about the concepts Tenant, PSU and delegate in the Developer resources

The first name, last name and correspondence name of the delegate are retrieved from https://www.statenspersonadressregister.se/

This request will result in a signing redirect HTTP 313 Needs Signing. You must call Verify to complete the request. The response of the Verify request is 202 Accepted with an empty body.

post/psu/{psuId}/delegate

Request

  • Base URL: https://bankapidemo.svea.com
  • URL: https://bankapidemo.svea.com/psu/{psuId}/delegate
  • Auth: Bearer (a scheme the document does not define)

Path parameters

psuIdstring uuid required
Example:febbe8f2-bd6b-4e53-89c6-e89ca92ff5ee

Headers

Authorizationstring required
Example:Bearer {BearerToken}
X-Svea-ClientAppstring required

Tenant client app name, version, and optional comment <client-app-name>/<version>(/<comment>)

Example:TENANT-IOS/0.99.0
X-Svea-CorrelationIdstring uuid

The correlationId is a unique identifier value that is attached to requests and messages that allow reference to a particular transaction or event chain. Used to follow transaction information, especially for logging purposes.

Example:21436a05-d62d-4f29-a253-31b3815d148b
X-Svea-SessionIdstring uuid

The sessionId is a unique identifier value for a users session. This identifier should be the same for the entire duration of that users session. Mainly used for logging and troubleshooting purposes.

Example:afe56332-dee2-48b4-ae0b-d694a6174a7e

Request body

accessLevel'restrictedLevel' | 'fullAccessLevel' | 'approveLevel' | 'prepareLevel' | 'cardHolderLevel' required

Note! New accessLevels are created upon request by the tenant and must be supported in the clients before delivery to production.

personKeystring required

Example request

{
  "accessLevel": "restrictedLevel",
  "accessLevelContext": [
    {
      "accountAccessLevel": "read",
      "bankAccountId": "ccf7c77a-8e32-4d9b-8f40-ea446f37d492"
    }
  ],
  "personKey": "199204049374"
}

Response

Accepted

Changes

No recorded changes to this operation across all 1 revision of this API.