Actito
Returns the current Actito configuration for this tenant. The API key is never returned; the response contains hasApiKey instead. Returns 404 when Actito is not configured.
Configuration returned.
The tenant's Actito connection, without the API key.
Root URL of the Actito API domain the entity lives on.
Name of the Actito entity the integration works in.
Name of the Actito profile table the holders' profiles are read from.
Attribute of the profile table matched against the pass identifier Neo.Extensions.Actito.Controllers.ActitoConfigurationResponse.TwcExternalIdentifier.
Name of the pass identifier matched against Neo.Extensions.Actito.Controllers.ActitoConfigurationResponse.ActitoExternalIdentifier.
Whether an API key is stored. When true, a PUT may omit apiKey to keep it.
The caller is not authenticated.
The caller lacks the tenant.actito.settings:read scope.
Actito is not configured for this tenant.
Over 1200 requests per minute to this endpoint for the tenant (default limit); retry after Retry-After.
GET /api/{tenantId}/admin/extensions/actito HTTP/1.1
Host: app.neostore.cloud
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"server": "https://example.com",
"entity": "text",
"profileTableName": "text",
"actitoExternalIdentifier": "text",
"twcExternalIdentifier": "text",
"hasApiKey": true
}Creates or replaces the Actito configuration. Omit apiKey to keep the saved API key. Returns 400 if the API key is missing and none was saved before.
Connection to the tenant's Actito entity, and how an Actito profile is matched to the holder's passes.
Root URL of the Actito API domain the entity lives on, e.g. https://api3.actito.com.
Name of the Actito entity that holds the profile table, and in which the integration keeps its wallet and pass template tables, custom actions and webhook subscriptions.
Name of the Actito profile table the holders' profiles are read from.
Attribute of the profile table that carries the holder identifier shared with The Wallet Crew, e.g.
customerId. Its value is matched against the pass identifier named by
Neo.Extensions.Actito.Controllers.SetActitoRequest.TwcExternalIdentifier.
Name of the pass identifier matched against Neo.Extensions.Actito.Controllers.SetActitoRequest.ActitoExternalIdentifier, e.g.
y2.customerId. A pass without this identifier is never linked to an Actito profile.
API key generated in the "Manage API users" page of the Actito portal. Never returned.
Configuration saved.
No content
Request body is invalid or an API key is required but missing.
The caller is not authenticated.
The caller lacks the tenant.actito.settings:write scope.
Over 1200 requests per minute to this endpoint for the tenant (default limit); retry after Retry-After.
PUT /api/{tenantId}/admin/extensions/actito HTTP/1.1
Host: app.neostore.cloud
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 153
{
"server": "https://example.com",
"entity": "text",
"profileTableName": "text",
"actitoExternalIdentifier": "text",
"twcExternalIdentifier": "text",
"apiKey": null
}No content
Write a value on a holder's passes from an Actito scenario
Called by Actito when the integration's custom action runs. Finds every pass whose twcExternalIdentifier identifier equals the profile's actitoExternalIdentifier attribute, sets the actito_{key} additional data to the action's value, saves each pass and pushes it to the wallets, then posts to the action's notifyOK callback.
A 4xx means the message cannot be processed as configured, so Actito stops retrying it; a 5xx is retried.
Passes updated and Actito notified; also when no pass matches the holder.
No content
The message has no readable data, no notifyOK link, a pass template unknown to this tenant, or no string or number profileAttributes.{actitoExternalIdentifier} value.
The caller is not authenticated.
The caller lacks the tenant.actito.listener:write scope, or the endpoint is not enabled for the tenant.
Over 1200 requests per minute to this endpoint for the tenant (default limit); retry after Retry-After.
POST /api/{tenantId}/webhooks/listeners/actito/custom-actions/updatePass HTTP/1.1
Host: app.neostore.cloud
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
No content
Link a holder's passes to their Actito profile
Called by Actito when a profile is created, or when its actitoExternalIdentifier attribute changes. Reads the profile from the profile table, finds the passes whose twcExternalIdentifier identifier equals that attribute, and records in the integration's wallet table in Actito the holder's most recently created Apple pass installed on a device and most recently created Google pass, each linked to the profile. No pass is changed.
The same event type, operation and profile received again within 2 hours answers 208 and is not processed again.
Profile table event Actito reports. The integration subscribes to both, the update one only for changes
of the profile attribute named by actitoExternalIdentifier.
Envelope of an Actito profile webhook.
Event type as Actito names it.
Operation name as Actito names it. With the route's event type and the profile, identifies the event.
Event processed; also when no pass matches the profile.
No content
The same event was already received within the last 2 hours; nothing is done.
The caller is not authenticated.
The caller lacks the tenant.actito.listener:write scope, or the endpoint is not enabled for the tenant.
Over 1200 requests per minute to this endpoint for the tenant (default limit); retry after Retry-After.
POST /api/{tenantId}/webhooks/listeners/actito/profile/{eventType} HTTP/1.1
Host: app.neostore.cloud
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 62
{
"eventType": "text",
"operation": "text",
"data": {
"profileId": 1
}
}No content
Last updated