Queue uploaded payment-control imports for processing

curl --request POST \
  --url https://lens-api.tic.io/payment-controls/imports/process \
  --header 'Content-Type: application/json-patch+json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "importGuids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "correlationId": "<string>",
  "webhookUrl": "<string>",
  "webhookSecret": "<string>"
}
'

{
  "processedCount": 123,
  "skippedCount": 123,
  "errors": [
    "<string>"
  ]
}

Payment Control Import

Queue uploaded payment-control imports for processing

Publishes a RabbitMQ command for each import that is still in Submitted status. Status delivery on completion has two mutually exclusive modes:

SignalR (default for the Lens UI): supply correlationId. The import service posts a callback to the internal Lens webhook, which broadcasts to the caller via the LensPaymentControlImportStatus event.
Webhook (for API integrators): supply webhookUrl (HTTPS recommended) and an optional webhookSecret. The import service POSTs a signed JSON envelope (PaymentControlImportStatus_Request shape) to your URL on terminal status. Verify X-TIC-Signature (HMAC-SHA256 of the body with your secret).

Imports already past Submitted are silently skipped. When both modes are supplied, webhookUrl wins and no SignalR broadcast occurs for that import.

POST

payment-controls

imports

process

Queue uploaded payment-control imports for processing

curl --request POST \
  --url https://lens-api.tic.io/payment-controls/imports/process \
  --header 'Content-Type: application/json-patch+json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "importGuids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "correlationId": "<string>",
  "webhookUrl": "<string>",
  "webhookSecret": "<string>"
}
'

{
  "processedCount": 123,
  "skippedCount": 123,
  "errors": [
    "<string>"
  ]
}

Enterprise+ tier

Authorizations

x-api-key

string

header

required

Body

importGuids

null | string<uuid>[]

correlationId

null | string

webhookUrl

null | string

webhookSecret

null | string

Response

Processed/skipped counts and any per-import errors

processedCount

integer<int32>

skippedCount

integer<int32>

errors

null | string[]

Get a single payment-control import Download the original uploaded XML