Skip to main content

Initialize Payment Session

POST 
/public/api/v1/cit

Initializes a new payment session with the ePay Payments API. This endpoint requires a valid ApiKey and must be called from the server side to ensure the ApiKey is never exposed client-side.

You’ll receive the outcome of the payment session on the notificationUrl you provide within the request, making it the primary way to track the result of this payment. Webhooks can be used separately if you need broader, system-wide updates.

We recommend a minimum timeout of 5 seconds.

Required or configurable fields

In the ePay backoffice, under Advanced Point of Sale Settings, you can set default values for many session initialization parameters. This allows you to manage your setup without updating your code.

Each property must be defined either in the backoffice or in the API request. If a value is provided in the API request, it overrides the backoffice default.

The following fields can be configured:

  • scaMode
  • timeout
  • instantCapture
  • processor
  • maxAttempts
  • notificationUrl
  • successUrl
  • failureUrl
  • exemptions Note: Only a subset of these fields are strictly required for the API request. The table below indicates which fields are mandatory or optional.

Request​

Responses​

Successful payment session initialization response.