Discrepancies

Resolve charge status discrepancy

When charge status mismatches with Gateway and is in cancellable state, charge is cancelled. Otherwise no action takes place

post/v1/api/discrepancies/resolve

Request body

string[] required

Example request

[
  "charge-external-id"
]

Response

OK

chargeIdstring

gatewayExternalStatus'EXTERNAL_CREATED' | 'EXTERNAL_STARTED' | 'EXTERNAL_SUBMITTED' | 'EXTERNAL_CAPTURABLE' | 'EXTERNAL_SUCCESS' | 'EXTERNAL_FAILED_REJECTED' | 'EXTERNAL_FAILED_EXPIRED' | 'EXTERNAL_FAILED_CANCELLED' | 'EXTERNAL_CANCELLED' | 'EXTERNAL_ERROR_GATEWAY'

gatewayStatus'UNDEFINED' | 'CREATED' | 'PAYMENT NOTIFICATION CREATED' | 'ENTERING CARD DETAILS' | 'AUTHORISATION ABORTED' | 'AUTHORISATION READY' | 'AUTHORISATION 3DS REQUIRED' | 'AUTHORISATION 3DS READY' | 'AUTHORISATION SUBMITTED' | 'AUTHORISATION SUCCESS' | 'AUTHORISATION REJECTED' | 'AUTHORISATION CANCELLED' | 'AUTHORISATION ERROR' | 'AUTHORISATION TIMEOUT' | 'AUTHORISATION UNEXPECTED ERROR' | 'AWAITING CAPTURE REQUEST' | 'CAPTURE APPROVED' | 'CAPTURE APPROVED RETRY' | 'CAPTURE READY' | 'CAPTURED' | 'CAPTURE SUBMITTED' | 'CAPTURE ERROR' | 'CAPTURE QUEUED' | 'AUTHORISATION USER NOT PRESENT QUEUED' | 'EXPIRE CANCEL READY' | 'EXPIRE CANCEL FAILED' | 'EXPIRE CANCEL SUBMITTED' | 'EXPIRED' | 'SYSTEM CANCEL READY' | 'SYSTEM CANCEL ERROR' | 'SYSTEM CANCEL SUBMITTED' | 'SYSTEM CANCELLED' | 'USER CANCEL READY' | 'USER CANCEL SUBMITTED' | 'USER CANCELLED' | 'USER CANCEL ERROR' | 'AUTHORISATION ERROR CANCELLED' | 'AUTHORISATION ERROR REJECTED' | 'AUTHORISATION ERROR CHARGE MISSING'

payExternalStatusstring

payStatus'UNDEFINED' | 'CREATED' | 'PAYMENT NOTIFICATION CREATED' | 'ENTERING CARD DETAILS' | 'AUTHORISATION ABORTED' | 'AUTHORISATION READY' | 'AUTHORISATION 3DS REQUIRED' | 'AUTHORISATION 3DS READY' | 'AUTHORISATION SUBMITTED' | 'AUTHORISATION SUCCESS' | 'AUTHORISATION REJECTED' | 'AUTHORISATION CANCELLED' | 'AUTHORISATION ERROR' | 'AUTHORISATION TIMEOUT' | 'AUTHORISATION UNEXPECTED ERROR' | 'AWAITING CAPTURE REQUEST' | 'CAPTURE APPROVED' | 'CAPTURE APPROVED RETRY' | 'CAPTURE READY' | 'CAPTURED' | 'CAPTURE SUBMITTED' | 'CAPTURE ERROR' | 'CAPTURE QUEUED' | 'AUTHORISATION USER NOT PRESENT QUEUED' | 'EXPIRE CANCEL READY' | 'EXPIRE CANCEL FAILED' | 'EXPIRE CANCEL SUBMITTED' | 'EXPIRED' | 'SYSTEM CANCEL READY' | 'SYSTEM CANCEL ERROR' | 'SYSTEM CANCEL SUBMITTED' | 'SYSTEM CANCELLED' | 'USER CANCEL READY' | 'USER CANCEL SUBMITTED' | 'USER CANCELLED' | 'USER CANCEL ERROR' | 'AUTHORISATION ERROR CANCELLED' | 'AUTHORISATION ERROR REJECTED' | 'AUTHORISATION ERROR CHARGE MISSING'

processedboolean

rawGatewayResponsestring

Example response

[
  {
    "chargeId": "2c6vtn9pth38ppbmnt20d57t49",
    "gatewayExternalStatus": "EXTERNAL_SUBMITTED",
    "gatewayStatus": "AUTHORISED",
    "payExternalStatus": "EXTERNAL_SUBMITTED",
    "payStatus": "AUTHORISATION SUCCESS",
    "rawGatewayResponse": "Worldpay response ()"
  }
]

Changes

Changed in 3 of the 59 revisions of this API.21

Jan 20, 20261399e201430d1See the full diff
- ▲
  the items/ request property's minLength was increased from 0 to 1
  request-property-min-length-increased
Nov 25, 2025fd04dddaa48d1See the full diff
- ○
  the items/ request property's minLength was decreased from 1 to 0
  request-property-min-length-decreased
Apr 10, 20258ad9796ed7501See the full diff
- ▲
  the items/ request property's minLength was increased from 0 to 1
  request-property-min-length-increased