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.

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.