Void a (Void of Settle)
POST/payments/{payment-id}/settles/{settle-id}/voids/{void-id}/voids
Voids a previous Void request of a settle.
Request
Path Parameters
Payment ID generated by REST API
Settle ID generated by REST API
Void ID generated by REST API
Header Parameters
Idempotency Key for the request
- application/json
Body
required
Processing entityId
provided by Nuvei.
ID of the transaction in the merchant system.
Possible values: <= 45 characters
A free text field used to identify the product/service sold. If this parameter is left empty, need to insert a concatenation of all item names. It's not related to rebilling system product id. Risk rules and traffic management rules are usually built based on this field value.
Possible values: <= 50 characters
Possible values: <= 255 characters
custom
object
subMerchant
object
Represents the internal merchant’s ID, which is forwarded to Visa and Mastercard
Possible values: <= 15 characters
The payment facilitator’s sub-merchant’s city name.
Possible values: <= 20 characters
The payment facilitator’s sub-merchant’s 2-letter ISO country code.
Possible values: >= 2 characters
and <= 2 characters
urlDetails
object
With this class, a merchant can dynamically provide possible URLs to which the end user is redirected after a payment is made, as well as a dynamic URL for DMNs.
The URL to which notifications for outcome of the financial transactions is sent.
The URL to which the end user is redirected for a successful transaction with an APM.
The URL to which the end user is redirected for an unsuccessful transaction with an APM.
The URL to which the end user is redirected for a pending transaction with an APM.
Responses
- 201
- 400
- 401
- 403
- 404
- 500
OK
- application/json
- Schema
- Example (from schema)
Schema
2f00eba7-66ad-4d8b-8d54-b8c9183e664f
Nuvei Digital Payments Gateway Transaction ID
Possible values: <= 20 characters
The transaction ID of the transaction in the event that an external service is used.
Possible values: <= 50 characters
result
object
required
Possible values: [approved
, authorizedOnly
, declined
, error
, pending
, redirect
, challenge
, fingerprint
, authenticated
, authenticationNotSupported
]
errors
object
Possible values: <= 11 characters
7000.1000
Possible values: <= 400 characters
Internal Processing Error
The authorization code of the transaction.
Possible values: <= 128 characters
providerResponseDetails
object
Possible values: <= 100 characters
Possible values: <= 400 characters
additionalTransactionInfo
object
{
"voidId": "2f00eba7-66ad-4d8b-8d54-b8c9183e664f",
"transactionId": "string",
"externalTransactionId": "string",
"result": {
"status": "approved",
"errors": {
"code": "7000.1000",
"reason": "Internal Processing Error"
}
},
"authCode": "string",
"providerResponseDetails": {
"code": "string",
"reason": "string"
},
"additionalTransactionInfo": {
"additionalTransactionBankId": "string",
"referenceId": "string"
}
}
Bad Request
- application/json
- Schema
- Example (from schema)
Schema
2f00eba7-66ad-4d8b-8d54-b8c9183e664f
Nuvei Digital Payments Gateway Transaction ID
Possible values: <= 20 characters
The transaction ID of the transaction in the event that an external service is used.
Possible values: <= 50 characters
result
object
required
Possible values: [approved
, authorizedOnly
, declined
, error
, pending
, redirect
, challenge
, fingerprint
, authenticated
, authenticationNotSupported
]
errors
object
Possible values: <= 11 characters
7000.1000
Possible values: <= 400 characters
Internal Processing Error
The authorization code of the transaction.
Possible values: <= 128 characters
providerResponseDetails
object
Possible values: <= 100 characters
Possible values: <= 400 characters
additionalTransactionInfo
object
{
"voidId": "2f00eba7-66ad-4d8b-8d54-b8c9183e664f",
"transactionId": "string",
"externalTransactionId": "string",
"result": {
"status": "approved",
"errors": {
"code": "7000.1000",
"reason": "Internal Processing Error"
}
},
"authCode": "string",
"providerResponseDetails": {
"code": "string",
"reason": "string"
},
"additionalTransactionInfo": {
"additionalTransactionBankId": "string",
"referenceId": "string"
}
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
2f00eba7-66ad-4d8b-8d54-b8c9183e664f
Nuvei Digital Payments Gateway Transaction ID
Possible values: <= 20 characters
The transaction ID of the transaction in the event that an external service is used.
Possible values: <= 50 characters
result
object
required
Possible values: [approved
, authorizedOnly
, declined
, error
, pending
, redirect
, challenge
, fingerprint
, authenticated
, authenticationNotSupported
]
errors
object
Possible values: <= 11 characters
7000.1000
Possible values: <= 400 characters
Internal Processing Error
The authorization code of the transaction.
Possible values: <= 128 characters
providerResponseDetails
object
Possible values: <= 100 characters
Possible values: <= 400 characters
additionalTransactionInfo
object
{
"voidId": "2f00eba7-66ad-4d8b-8d54-b8c9183e664f",
"transactionId": "string",
"externalTransactionId": "string",
"result": {
"status": "approved",
"errors": {
"code": "7000.1000",
"reason": "Internal Processing Error"
}
},
"authCode": "string",
"providerResponseDetails": {
"code": "string",
"reason": "string"
},
"additionalTransactionInfo": {
"additionalTransactionBankId": "string",
"referenceId": "string"
}
}
Forbidden
- application/json
- Schema
- Example (from schema)
Schema
2f00eba7-66ad-4d8b-8d54-b8c9183e664f
Nuvei Digital Payments Gateway Transaction ID
Possible values: <= 20 characters
The transaction ID of the transaction in the event that an external service is used.
Possible values: <= 50 characters
result
object
required
Possible values: [approved
, authorizedOnly
, declined
, error
, pending
, redirect
, challenge
, fingerprint
, authenticated
, authenticationNotSupported
]
errors
object
Possible values: <= 11 characters
7000.1000
Possible values: <= 400 characters
Internal Processing Error
The authorization code of the transaction.
Possible values: <= 128 characters
providerResponseDetails
object
Possible values: <= 100 characters
Possible values: <= 400 characters
additionalTransactionInfo
object
{
"voidId": "2f00eba7-66ad-4d8b-8d54-b8c9183e664f",
"transactionId": "string",
"externalTransactionId": "string",
"result": {
"status": "approved",
"errors": {
"code": "7000.1000",
"reason": "Internal Processing Error"
}
},
"authCode": "string",
"providerResponseDetails": {
"code": "string",
"reason": "string"
},
"additionalTransactionInfo": {
"additionalTransactionBankId": "string",
"referenceId": "string"
}
}
Not Found
- application/json
- Schema
- Example (from schema)
Schema
2f00eba7-66ad-4d8b-8d54-b8c9183e664f
Nuvei Digital Payments Gateway Transaction ID
Possible values: <= 20 characters
The transaction ID of the transaction in the event that an external service is used.
Possible values: <= 50 characters
result
object
required
Possible values: [approved
, authorizedOnly
, declined
, error
, pending
, redirect
, challenge
, fingerprint
, authenticated
, authenticationNotSupported
]
errors
object
Possible values: <= 11 characters
7000.1000
Possible values: <= 400 characters
Internal Processing Error
The authorization code of the transaction.
Possible values: <= 128 characters
providerResponseDetails
object
Possible values: <= 100 characters
Possible values: <= 400 characters
additionalTransactionInfo
object
{
"voidId": "2f00eba7-66ad-4d8b-8d54-b8c9183e664f",
"transactionId": "string",
"externalTransactionId": "string",
"result": {
"status": "approved",
"errors": {
"code": "7000.1000",
"reason": "Internal Processing Error"
}
},
"authCode": "string",
"providerResponseDetails": {
"code": "string",
"reason": "string"
},
"additionalTransactionInfo": {
"additionalTransactionBankId": "string",
"referenceId": "string"
}
}
Internal Server Error
- application/json
- Schema
- Example (from schema)
Schema
2f00eba7-66ad-4d8b-8d54-b8c9183e664f
Nuvei Digital Payments Gateway Transaction ID
Possible values: <= 20 characters
The transaction ID of the transaction in the event that an external service is used.
Possible values: <= 50 characters
result
object
required
Possible values: [approved
, authorizedOnly
, declined
, error
, pending
, redirect
, challenge
, fingerprint
, authenticated
, authenticationNotSupported
]
errors
object
Possible values: <= 11 characters
7000.1000
Possible values: <= 400 characters
Internal Processing Error
The authorization code of the transaction.
Possible values: <= 128 characters
providerResponseDetails
object
Possible values: <= 100 characters
Possible values: <= 400 characters
additionalTransactionInfo
object
{
"voidId": "2f00eba7-66ad-4d8b-8d54-b8c9183e664f",
"transactionId": "string",
"externalTransactionId": "string",
"result": {
"status": "approved",
"errors": {
"code": "7000.1000",
"reason": "Internal Processing Error"
}
},
"authCode": "string",
"providerResponseDetails": {
"code": "string",
"reason": "string"
},
"additionalTransactionInfo": {
"additionalTransactionBankId": "string",
"referenceId": "string"
}
}