Payment App Charge Attempt Update Request

The charge attempt update request allows to change the state of a charge attempt. The charge attempt must be linked with a processor that was created by the payment Web App that invokes the operation.

  • Charge Attempt ID
    This is the ID of the charge attempt that should be updated.
  • End User Failure Message
    The end user failure message indicates to the end user (buyer) why the payment failed. The message has to be in the language of the end user. The language is provided within the payment page invocation URL.
  • Failure Reason ID
    The failure reason indicates why the charge attempt failed. It is required when the target state is FAILED.
  • Reference
    The reference identifies the charge attempt within the systems of the external service provider. It is required when the target state is SUCCESSFUL.
  • Target State
    The target state defines the state into which the charge attempt should be switched into. Once the charge attempt changed the state it will not be possible to change it again.