API Guide
Log In
API Guide

Checkout

Calling Checkout with a valid pay run ID will return a URL that the user should be redirected to in order to initiate
the payment process for the given pay run.

When calling this endpoint you are expected to provide completeUrl and incompleteUrl
query parameters which will be used to redirect the user back to your system following the checkout process
depending on whether all batch processing is complete or not. Regardless of the URL used webhooks and/or
status endpoints should always be used to obtain most accurate status information.

Calling /checkout with a valid pay run ID will return a 302 redirect to the UI to allow a user to checkout

Supplying a completeURL and incompleteUrl

When calling this endpoint you are expected to provide completeUrl and incompleteUrl
query parameters which will be used to redirect the user back to your system following the checkout process
depending on whether all batch processing is complete or not. Regardless of the URL used webhooks and/or
status endpoints should always be used to obtain most accurate status information.

Redirecting versus sharing the checkout link

The optional linkUsage query parameter declares how you intend to use the returned URL:

  • Redirect (the default when omitted) β€” the current user will be redirected to the URL immediately.
  • Share β€” the URL will be passed to another user out of band, for example emailed to an approver.

Checkout configuration (the return URLs and the link usage) is stored per pay run, not per link. Each
checkout call replaces it, so any previously issued links follow the most recent call's configuration.

Path Params
uuid
required

The unique Crezco ID for an organisation

uuid
required

The unique pay run ID for the pay run

Query Params
string
required
length β‰₯ 1

The URL that we should redirect the user back to following the checkout process when all constituent batches have
reached the processed state.

If not specified then this parameter must be specified on the supplied checkout URL itself.

string
required
length β‰₯ 1

The URL that we should redirect the user back to following the checkout process when not all of the constituent
batches have reached the processed state.

If not specified then this parameter must be specified on the supplied checkout URL itself.

string | null

UserId of the user that intends to authorise the pay run batch(es)

string | null

Declares how you will use the returned checkout URL. Use Redirect
(the default when omitted) when the current user will be redirected to the URL immediately.
Use Share when the URL will be passed to another user out of band, for example
emailed to an approver.

Checkout configuration (the return URLs and the link usage) is stored per pay run, not per link.
Each checkout call replaces it, and any previously issued links are invalidated.

Headers
string
Defaults to 2025-01-31

The requested API version

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

404

Not Found

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json