| DELETE | /api/v1/paymentAccount/{paymentAccountId} | Marks the given payment account for deletion | This endpoint deletes a payment account created with POST /api/v1/paymentAccount. This endpoint returns an HTTP status code of 200 if the payment account was successfully deleted. Other HTTP status code responses indicate failure. If the payment account is not found, an HTTP status code 404 is returned. After a successful delete, this endpoint will continue to return HTTP status code 200 until the Express processing platform purges the payment account from the system. Payment account purge typically happens within 48 hours. After 48 hours, this endpoint will return a 404 Not Found HTTP status code for the deleted payment account. |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| PaymentAccountId | path | string | Yes | The payment account ID to update. |
| CardHolderPresentCode | query | CardHolderPresentCode? | No | Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.Allowable Values
|
| ClerkNumber | query | string | No | An optional clerk number for reference. |
| LaneId | query | int | No | Specifies which lane to use. |
| ReferenceNumber | query | string | No | A user defined reference number. |
| ShiftId | query | string | No | An optional shift id for reference. |
| TicketNumber | query | string | No | An optional ticket number. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| MerchantId | form | string | No | The merchant ID. |
| PaymentAccountId | form | string | No | The payment account ID that was deleted. |
| Processor | form | Processor | No | Response information from the processor. |
| TerminalId | form | string | No | The ID of the terminal used during the transaction |
| TransactionDateTime | form | string | No | Transaction date/time in ISO8601 format |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Errors | form | List<ApiError> | No | A list of errors that occurred. |
| HasErrors | form | bool | No | Indicates if there are errors. |
| Links | form | IEnumerable<ApiLink> | No | A list of resource links |
| Logs | form | List<string> | No | A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose. |
| Type | form | string | No | The type of object held in the result. |
| Warnings | form | List<ApiWarning> | No | A list of warnings that occurred. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| UserMessage | form | string | No | An error message targeted at the end user of the integrated business application. |
| DeveloperMessage | form | string | No | An error message targeted at the developer of the integrated business application. |
| ErrorType | form | string | No | Code associated with the error if it exists. |
| ExceptionMessage | form | string | No | The body of the exception message. |
| ExceptionTypeFullName | form | string | No | The full name of the exception. |
| ExceptionTypeShortName | form | string | No | The short name of the exception. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Href | form | string | No | A target (a URI) |
| Method | form | string | No | The HTTP method to access the HREF target |
| Relation | form | string | No | The relation aka. 'rel' (the name of the link) |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| DeveloperMessage | form | string | No | A warning message targeted at the developer of the integrated business application. |
| UserMessage | form | string | No | A warning message targeted at the end user of the integrated business application. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ProcessorLogs | form | List<string> | No | [DEPRECATED] Use logs. |
| ProcessorRawResponse | form | string | No | [DEPRECATED] Use rawResponse. |
| ProcessorReferenceNumber | form | string | No | [DEPRECATED] Use the same reference number passed in the request. |
| ProcessorRequestFailed | form | bool | No | [DEPRECATED] Use top level properties (e.g. hasErrors). |
| ProcessorRequestWasApproved | form | bool | No | [DEPRECATED] Use top level properties (e.g isApproved). |
| ProcessorResponseCode | form | ProcessorResponseCode | No | [DEPRECATED] Use expressResponseCode.Allowable Values
|
| ProcessorResponseMessage | form | string | No | [DEPRECATED] Use expressResponseMessage. |
| ExpressResponseCode | form | string | No | The response code received from Express. |
| ExpressResponseMessage | form | string | No | The response message received from Express. |
| HostResponseCode | form | string | No | The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host. |
| HostResponseMessage | form | string | No | The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host. |
| Logs | form | List<string> | No | A list of messages pertaining processing the transaction. |
| RawResponse | form | string | No | The raw processor response. In the case of Express, this is the raw XML returned by the Express platform. |
| RawRequest | form | string | No | |
| ProcessorName | form | ProcessorName | No |
To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json
To embed the response in a jsonp callback, append ?callback=myCallback
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /json/reply/DeletePaymentAccountRequest HTTP/1.1
Host: triposqa.vantiv.com
Content-Type: application/json
Content-Length: length
{"paymentAccountId":"String","cardHolderPresentCode":"Default","clerkNumber":"String","laneId":0,"referenceNumber":"String","shiftId":"String","ticketNumber":"String"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length
{"merchantId":"String","paymentAccountId":"String","_processor":{"processorLogs":["String"],"processorRawResponse":"String","processorReferenceNumber":"String","processorRequestFailed":false,"processorRequestWasApproved":false,"processorResponseCode":"Unknown","processorResponseMessage":"String","expressResponseCode":"String","expressResponseMessage":"String","hostResponseCode":"String","hostResponseMessage":"String","logs":["String"],"rawResponse":"String","rawRequest":"String","processorName":"Unknown"},"terminalId":"String","transactionDateTime":"String","_errors":[{"userMessage":"String","developerMessage":"String","errorType":"String","exceptionMessage":"String","exceptionTypeFullName":"String","exceptionTypeShortName":"String"}],"_hasErrors":true,"_links":[],"_logs":["String"],"_type":"String","_warnings":[{"developerMessage":"String","userMessage":"String"}]}