Skip to main content

/tickets/transfer/{confirmationCd}

Description

This call will cancel the transfer.

Supported Methods

  1. DELETE

Request

/tickets/transfer/{confirmationCd}

HEADERS

RCOPropertyTypeDescription
RUser-AgentStringAn identifying string in Product/Version format, where Version is a SemVer-compliant string, that uniquely identifies your application.
RAuthorizationStringIt's required to use the "Bearer" authentication scheme to transmit the access token.
RAcceptStringThe only supported response type for this endpoint is application/json.
OAccept-EncodingStringgzip compression is supported.
RContent-TypeStringThe only supported request type for this endpoint is application/json.
RPAC-Channel-CodeStringThe channel partner identifier issued to your organization by the Paciolan Partner Services team partner on-boarding.
RPAC-Application-IDStringThe application identifier for which API access has been authorized; this value is typically expressed in reverse domain notation and is bound to an API key provided by Paciolan during provisioning.
RPAC-API-KeyStringThe API key provided by Paciolan for this application.
RRequest-IDStringA unique ID provided for debugging purposes
RPAC-Organization-IDStringPAC-Organization-ID String The client's data account ID to pull events from.

Response

Response Object

PropertyTypeDescription
patronIdStringUnique customer id
confirmationCdStringtranferId returned by Backoffice
cancelDtStringCancel date and time MM/dd/yyyy HH:mm:ss (using the 24-hour clock)
transferStatusStringCurrent transfer status

Error Response Object

PropertyTypeDescription
errorObjectError details
typeStringError type that has occurred
developerMessageStringGeneric description of error that occurred
appErrorCodeStringInternal error code used for support. Depending on type returned, this code may be needed to handle error response differently

Error Types

Error TypeError DescApp Error CodeHTTP Status CodeHTTP Status DescRetry PossibleRetry CountUltimate actionMS Error Level
INVALID_PARAMETER_VALUEInvalid Code ProvidedMS-400400Bad RequestNo0Caller to inform ProviderERROR
INVALID_PARAMETER_VALUEThis Seats cannot be canceled at this timeMS-422422Unprocessable EntityNo0Caller to inform ProviderERROR
UNHANDLED_EXCEPTIONInternal server error occurred due to backend errorMS-500500Internal Server ErrorYes3Caller to inform ProviderFATAL

Examples

Request

curl --location --request DELETE 'https://link-sandbox.paciolan.info/v1/tickets/transfer/3785222-AMTX:10555' \
--header 'User-Agent: MyApplication/1.0' \
--header 'Authorization: Bearer <BearerToken>' \
--header 'PAC-Channel-Code: my-application' \
--header 'PAC-Application-ID: com.mycompany.myapp' \
--header 'PAC-API-Key: <ApiKey>' \
--header 'Request-ID: <RequestID>' \
--header 'PAC-Organization-ID: 999' \
--header 'Content-Type: application/json'

Responses

Success Response
< HTTP/1.1 200
{
"patronId": "3785222",
"confirmationCd": "3785222-AMTX:10270",
"cancelDt": "06/15/2023 09:43:12",
"transferStatus": "Cancelled"
}
Failure Response
< HTTP/1.1 400
{
"error": {
"type": "INVALID_PARAMETER_VALUE",
"developerMessage": "This Seats cannot be canceled at this time",
"appErrorCode": "MS-400"
}
}