Payments Events

Events related to payments

Subscribe

Subscribe to receive webhook events for payments

Securityapi_key or azure_auth
Request
path Parameters
SiteSlug
required
string <slug> (Slug) ^[osl][a-zA-Z0-9]{3,}$

The Slipstream slug that uniquely identifies a physical practice

Example: s8n6EzC
Request Body schema: application/json
required
Uri
required
string <uri>

The URI to deliver the events to

Array of objects or null

The headers that should be sent with the POST request to deliver the event

EventTypes
Array of strings or null

The types of events to subscribe to. If omitted, all events will be delivered

Responses
200

The subscription to payments events has been created successfully

400

Malformed Request (ProblemDetails)

401

Unauthorized - Provide proof of identity (ProblemDetails)

403

Forbidden - Insufficient permissions (ProblemDetails)

404

Not Found - Could not find a matching entity (ProblemDetails)

422

Unprocessable - Request was well formed but could not be actioned (ProblemDetails)

429

Too many requests - Chill out (ProblemDetails)

4XX

User Error (ProblemDetails)

5XX

Server Error (ProblemDetails)

put/sites/{SiteSlug}/webhooks/features/payments
Request samples
application/json
{}
Response samples
application/json
{}

Unsubscribe

Unsubscribe from receiving webhooks events for payments

Securityapi_key or azure_auth
Request
path Parameters
SiteSlug
required
string <slug> (Slug) ^[osl][a-zA-Z0-9]{3,}$

The Slipstream slug that uniquely identifies a physical practice

Example: s8n6EzC
Responses
200

The subscription to payment events has been deleted successfully

400

Malformed Request (ProblemDetails)

401

Unauthorized - Provide proof of identity (ProblemDetails)

403

Forbidden - Insufficient permissions (ProblemDetails)

404

Not Found - Could not find a matching entity (ProblemDetails)

422

Unprocessable - Request was well formed but could not be actioned (ProblemDetails)

429

Too many requests - Chill out (ProblemDetails)

4XX

User Error (ProblemDetails)

5XX

Server Error (ProblemDetails)

delete/sites/{SiteSlug}/webhooks/features/payments
Request samples
Response samples
application/json
{}

Get subscription information

Gets subscription information for payment events

Securityapi_key or azure_auth
Request
path Parameters
SiteSlug
required
string <slug> (Slug) ^[osl][a-zA-Z0-9]{3,}$

The Slipstream slug that uniquely identifies a physical practice

Example: s8n6EzC
Responses
200

Information of subscription to payments

400

Malformed Request (ProblemDetails)

401

Unauthorized - Provide proof of identity (ProblemDetails)

403

Forbidden - Insufficient permissions (ProblemDetails)

404

Not Found - Could not find a matching entity (ProblemDetails)

422

Unprocessable - Request was well formed but could not be actioned (ProblemDetails)

429

Too many requests - Chill out (ProblemDetails)

4XX

User Error (ProblemDetails)

5XX

Server Error (ProblemDetails)

get/sites/{SiteSlug}/webhooks/features/payments
Request samples
Response samples
application/json
{}

Payment CancelledWebhook

A payment has been cancelled

Request
Request Body schema: application/cloudevent+json

Payment Cancelled

object or null (PaymentCancelledEvent)

Details about the cancelled payment

type
required
string
Value: "Slipstream.Payments.Payment.Cancelled"
specversion
required
id
required
source
required
subject
time
string or null <date-time>
datacontenttype
string or null

The content type of the data field. Assume application/slipstreamevent+json if missing

dataschema
siteslug
string <slug> (Slug) ^[osl][a-zA-Z0-9]{3,}$

A URL-safe unique identifier for an entity (See Sqids)

expirytime
intendeddeliverytime
string or null <date-time>

The time the event is intended to be delivered at. Not delivered before this time.

traceparent
tracestate
priority
integer or null

Priority of the event for time-sensitive processing.

Enum Value Description
0

Normal Priority

1

High Priority

2

Realtime Priority

organisationslug
string <slug> (Slug) ^[osl][a-zA-Z0-9]{3,}$

A URL-safe unique identifier for an entity (See Sqids)

billingorganisationslug
string <slug> (Slug) ^[osl][a-zA-Z0-9]{3,}$

A URL-safe unique identifier for an entity (See Sqids)

product
string (PracticeManagementSoftware)

Software systems

Enum Value Description
Unknown

Unknown PMS - not valid

Testing

Used for automated testing, not a real software system

Exact

Exact Dental

Dentally

Dentally Cloud

Ascend

Ascend

dataref
visibility
integer or null
Default: 0

Controls the scope of an event's visibility. Possible values: - 0: Internal – The event can be subscribed to by other slipstream services, but is not available as a webhook (default when omitted) - 1: Public – The event is published as a webhook and can be subscribed to by authorized external systems - 2: WorkQueue – The event will be published to a work queue for later processing by the publishing service - 3: Private – The event is not published to a broker; it is only visible within the service publishing it and in telemetry For events from external systems, only Internal and Public are valid values.

Enum Value Description
0

Internal

1

Public

2

WorkQueue

3

Private

billingsku
string or null

Encodes a billable item and any relevant options into a billing SKU which decides what it should cost.

billingpax
integer or null

How many of the given SKU this item should be billed for. Assumed to be 1 if omitted.

pmsspecificid
string (PmsSpecificPracticeId)

The PMS-specific id that uniquely identifies a physical practice

property name*
additional property
any
Responses
429

Try again later

2xx

Yep, got it

4XX

Can't process event - don't re-deliver

5XX

Something went wrong, try again

Request samples
application/cloudevent+json
{
  • "data": {
    },
  • "type": "Slipstream.UrlShortener.UrlCreated",
  • "specversion": "string",
  • "id": "string",
  • "source": "http://example.com",
  • "subject": "string",
  • "time": "2019-08-24T14:15:22Z",
  • "datacontenttype": "application/slipstreamevent+json",
  • "dataschema": "http://example.com",
  • "siteslug": "s8n6EzC",
  • "expirytime": "2021-04-24T18:25:43.511Z",
  • "intendeddeliverytime": "2021-04-23T20:25:43.511Z",
  • "traceparent": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01",
  • "tracestate": "string",
  • "priority": 1,
  • "organisationslug": "s8n6EzC",
  • "billingorganisationslug": "s8n6EzC",
  • "product": "Unknown",
  • "dataref": "/some/dataref",
  • "visibility": 0,
  • "billingsku": "string",
  • "billingpax": 1,
  • "pmsspecificid": "04d2f2f0-8f1a-11eb-8dcd-0242ac130003"
}

Payment FailedWebhook

A payment has failed

Request
Request Body schema: application/cloudevent+json

Payment Failed

object or null (PaymentFailedEvent)

Details about the failed payment

type
required
string
Value: "Slipstream.Payments.Payment.Failed"
specversion
required
id
required
source
required
subject
time
string or null <date-time>
datacontenttype
string or null

The content type of the data field. Assume application/slipstreamevent+json if missing

dataschema
siteslug
string <slug> (Slug) ^[osl][a-zA-Z0-9]{3,}$

A URL-safe unique identifier for an entity (See Sqids)

expirytime
intendeddeliverytime
string or null <date-time>

The time the event is intended to be delivered at. Not delivered before this time.

traceparent
tracestate
priority
integer or null

Priority of the event for time-sensitive processing.

Enum Value Description
0

Normal Priority

1

High Priority

2

Realtime Priority

organisationslug
string <slug> (Slug) ^[osl][a-zA-Z0-9]{3,}$

A URL-safe unique identifier for an entity (See Sqids)

billingorganisationslug
string <slug> (Slug) ^[osl][a-zA-Z0-9]{3,}$

A URL-safe unique identifier for an entity (See Sqids)

product
string (PracticeManagementSoftware)

Software systems

Enum Value Description
Unknown

Unknown PMS - not valid

Testing

Used for automated testing, not a real software system

Exact

Exact Dental

Dentally

Dentally Cloud

Ascend

Ascend

dataref
visibility
integer or null
Default: 0

Controls the scope of an event's visibility. Possible values: - 0: Internal – The event can be subscribed to by other slipstream services, but is not available as a webhook (default when omitted) - 1: Public – The event is published as a webhook and can be subscribed to by authorized external systems - 2: WorkQueue – The event will be published to a work queue for later processing by the publishing service - 3: Private – The event is not published to a broker; it is only visible within the service publishing it and in telemetry For events from external systems, only Internal and Public are valid values.

Enum Value Description
0

Internal

1

Public

2

WorkQueue

3

Private

billingsku
string or null

Encodes a billable item and any relevant options into a billing SKU which decides what it should cost.

billingpax
integer or null

How many of the given SKU this item should be billed for. Assumed to be 1 if omitted.

pmsspecificid
string (PmsSpecificPracticeId)

The PMS-specific id that uniquely identifies a physical practice

property name*
additional property
any
Responses
429

Try again later

2xx

Yep, got it

4XX

Can't process event - don't re-deliver

5XX

Something went wrong, try again

Request samples
application/cloudevent+json
{
  • "data": {
    },
  • "type": "Slipstream.UrlShortener.UrlCreated",
  • "specversion": "string",
  • "id": "string",
  • "source": "http://example.com",
  • "subject": "string",
  • "time": "2019-08-24T14:15:22Z",
  • "datacontenttype": "application/slipstreamevent+json",
  • "dataschema": "http://example.com",
  • "siteslug": "s8n6EzC",
  • "expirytime": "2021-04-24T18:25:43.511Z",
  • "intendeddeliverytime": "2021-04-23T20:25:43.511Z",
  • "traceparent": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01",
  • "tracestate": "string",
  • "priority": 1,
  • "organisationslug": "s8n6EzC",
  • "billingorganisationslug": "s8n6EzC",
  • "product": "Unknown",
  • "dataref": "/some/dataref",
  • "visibility": 0,
  • "billingsku": "string",
  • "billingpax": 1,
  • "pmsspecificid": "04d2f2f0-8f1a-11eb-8dcd-0242ac130003"
}

Payment SucceededWebhook

A payment has succeeded

Request
Request Body schema: application/cloudevent+json

Payment Succeeded

object or null (PaymentSucceededEvent)

Details about the succeddful payment

type
required
string
Value: "Slipstream.Payments.Payment.Succeeded"
specversion
required
id
required
source
required
subject
time
string or null <date-time>
datacontenttype
string or null

The content type of the data field. Assume application/slipstreamevent+json if missing

dataschema
siteslug
string <slug> (Slug) ^[osl][a-zA-Z0-9]{3,}$

A URL-safe unique identifier for an entity (See Sqids)

expirytime
intendeddeliverytime
string or null <date-time>

The time the event is intended to be delivered at. Not delivered before this time.

traceparent
tracestate
priority
integer or null

Priority of the event for time-sensitive processing.

Enum Value Description
0

Normal Priority

1

High Priority

2

Realtime Priority

organisationslug
string <slug> (Slug) ^[osl][a-zA-Z0-9]{3,}$

A URL-safe unique identifier for an entity (See Sqids)

billingorganisationslug
string <slug> (Slug) ^[osl][a-zA-Z0-9]{3,}$

A URL-safe unique identifier for an entity (See Sqids)

product
string (PracticeManagementSoftware)

Software systems

Enum Value Description
Unknown

Unknown PMS - not valid

Testing

Used for automated testing, not a real software system

Exact

Exact Dental

Dentally

Dentally Cloud

Ascend

Ascend

dataref
visibility
integer or null
Default: 0

Controls the scope of an event's visibility. Possible values: - 0: Internal – The event can be subscribed to by other slipstream services, but is not available as a webhook (default when omitted) - 1: Public – The event is published as a webhook and can be subscribed to by authorized external systems - 2: WorkQueue – The event will be published to a work queue for later processing by the publishing service - 3: Private – The event is not published to a broker; it is only visible within the service publishing it and in telemetry For events from external systems, only Internal and Public are valid values.

Enum Value Description
0

Internal

1

Public

2

WorkQueue

3

Private

billingsku
string or null

Encodes a billable item and any relevant options into a billing SKU which decides what it should cost.

billingpax
integer or null

How many of the given SKU this item should be billed for. Assumed to be 1 if omitted.

pmsspecificid
string (PmsSpecificPracticeId)

The PMS-specific id that uniquely identifies a physical practice

property name*
additional property
any
Responses
429

Try again later

2xx

Yep, got it

4XX

Can't process event - don't re-deliver

5XX

Something went wrong, try again

Request samples
application/cloudevent+json
{
  • "data": {
    },
  • "type": "Slipstream.UrlShortener.UrlCreated",
  • "specversion": "string",
  • "id": "string",
  • "source": "http://example.com",
  • "subject": "string",
  • "time": "2019-08-24T14:15:22Z",
  • "datacontenttype": "application/slipstreamevent+json",
  • "dataschema": "http://example.com",
  • "siteslug": "s8n6EzC",
  • "expirytime": "2021-04-24T18:25:43.511Z",
  • "intendeddeliverytime": "2021-04-23T20:25:43.511Z",
  • "traceparent": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01",
  • "tracestate": "string",
  • "priority": 1,
  • "organisationslug": "s8n6EzC",
  • "billingorganisationslug": "s8n6EzC",
  • "product": "Unknown",
  • "dataref": "/some/dataref",
  • "visibility": 0,
  • "billingsku": "string",
  • "billingpax": 1,
  • "pmsspecificid": "04d2f2f0-8f1a-11eb-8dcd-0242ac130003"
}