Skip to main content
The PC retry endpoint is used internally by the message handler chain to determine whether a new retry attempt should be created for a failed paper delivery request. It resolves the next retry requestId, the associated delivery driver, and the retry configuration based on the original request.
Base path: /paper-channel-private/v1/b2bThis is an internal API. It is not exposed publicly and requires network-level access to the private Paper Channel service.

​
Check PC retry

GET /paper-channel-private/v1/b2b/pc-retry/{requestId} Verifies whether a retry opportunity exists for the delivery request identified by requestId. When a retry is available, the response includes the new requestId to use for the next attempt, along with the parent request identifier and the assigned delivery driver. This endpoint is called by the ProxyCON996MessageHandler and related retry handlers when processing error events such as CON996.

​
Path parameters

​
requestId
string
required
The identifier of the paper delivery request to check for retry.
  • Minimum length: 5
  • Maximum length: 100

​
Query parameters

​
checkApplyRasterization
boolean
default:"false"
required
Set to true when called in response to a CON996 event (rasterization retry). Set to false for all other retry scenarios.This flag controls whether the retry logic checks for rasterization eligibility in addition to standard retry rules.

​
Responses

StatusMeaning
200Retry information resolved successfully.
404No delivery request found for the given requestId.
500Internal server error.

​
200 response — PcRetryResponse

​
requestId
string
The new requestId generated for the retry attempt, if a retry is available. Use this value to submit the next prepare or send request.
​
parentRequestId
string
The requestId of the original request from which this retry was generated.
​
deliveryDriverId
string
The identifier of the delivery driver assigned to the retry attempt.
​
pcRetry
string
Internal retry configuration string used to drive the retry logic.
​
retryFound
boolean
true if a valid retry opportunity was found for the request. false if no further retries are available.
curl --request GET \
  --url 'https://api.paperchannel.pagopa.local/paper-channel-private/v1/b2b/pc-retry/ABCD-HILM-YKWX-202202-1_rec0_try1?checkApplyRasterization=false'

{
  "requestId": "ABCD-HILM-YKWX-202202-1_rec0_try2",
  "parentRequestId": "ABCD-HILM-YKWX-202202-1_rec0_try1",
  "deliveryDriverId": "driver-poste-001",
  "pcRetry": "RETRY_CONFIG_1",
  "retryFound": true
}

Build docs developers (and LLMs) love

Get started for freeTalk to us