Skip to content
v2.7 (latest)

Ockto ​

Collection of Ockto functions, to get personal data from validated external sources.

Methods ​

startSession ​

javascript
startSession(sessionId: string, ocktoOptions: { testCaseId?: string, consentCode: Ockto.ConsentCodes, ocktoType: string, odmVersion: string, requestDocuments: string[], disablePartner: boolean, psd2InfoIncluded: boolean, psd2AmountOfMonths: number })

Starts an Ockto session. To be able to use Ockto, an applicable license must be configured for the Tenant.

Parameters

sessionId string

The sessionId used in Ockto.

ocktoOptions { testCaseId?: string, consentCode: Ockto.ConsentCodes, ocktoType: string, odmVersion: string, requestDocuments: string[], disablePartner: boolean, psd2InfoIncluded: boolean, psd2AmountOfMonths: number }

The Ockto options you want to use.

consentCodeConsent provided in the app to the user. View the Ockto support portal for more information.
ocktoTypeProvides the combination of datasources that needs to be collected by the consumer. Contact Ockto support to get the right type.
odmVersionThe version of ODM returned. When left empty or null is used, the latest ODM version will be returned. (V#_#).
requestDocumentsPer specified document a link is returned in the ODM. Using this link the receiver can download the document. Documents are available for 10 minutes and will be deleted when downloaded. By default Ockto does not return documents.
Possible values: UPO, UWV, PSD2, PDF
disablePartnerIf true, Ockto will not show the add partner data pop-up within the app.
psd2InfoIncludedIf set to true, Ockto will return PSD2 data.
psd2AmountOfMonthsNumber of months to be collected (up to 12 moths)

Return type

Examples

javascript
Ockto.startSession("ac1b098c-928b-4db2-8f47-ca1bec360eba", {
  consentCode: Ockto.ConsentCodes.Algemeen,
  ocktoType: "P",
  odmVersion: "v4_3",
  requestDocuments: [],
  disablePartner: true,
  psd2InfoIncluded: true,
  psd2AmountOfMonths: 3
})

getStatus ​

javascript
getStatus(sessionId: string)

Gets the status of an Ockto session.

Parameters

sessionId string

The sessionId used in Ockto.

Return type

string

Examples

javascript
Ockto.getStatus("ac1b098c-928b-4db2-8f47-ca1bec360eba")

getResult ​

javascript
getResult(sessionId: string)

Gets the result of an Ockto session.

Parameters

sessionId string

The sessionId used in Ockto.

Return type

{ [key: string]: any; }

Examples

javascript
Ockto.getResult("ac1b098c-928b-4db2-8f47-ca1bec360eba")