跳转到主要内容
DeclineCallback
The DeclineCallback API call is used to notify you of a failure in the Spark transaction process. It is typically triggered after a successful /TriggerTransaction response with a verdict of Approved, but when the flow subsequently fails for any reason before payment authorization.

请求体

application/json

The request payload containing details of the failed transaction.

The request payload sent by Spark to the integrator's /spark/DeclineCallback endpoint to report a failed transaction.

MachineId
integer<int64>

The unique ID of the vending machine or terminal where the transaction occurred.

HwSerial
string

The serial number of the hardware terminal.

SparkTransactionId
string | null

The unique identifier of the failed Spark transaction. This ID is typically generated during the StartAuthentication process.

Status
object

交易状态详情

响应

200 - application/json
object | null

Success. A simple 200 OK server acknowledgment is sufficient.

The response payload from the DeclineCallback endpoint, providing details about a failed Spark transaction. This payload confirms the transaction's failure and provides contextual information.

SparkTransactionId
string | null

The unique identifier for the failed Spark transaction session. This ID is initially generated during the StartAuthentication process and is used to track the session throughout its lifecycle.

Status
object

交易状态详情