Ticketing authorization update
1 min
POST
https://api.accertify.net/api/v1/unified-risk/ticketing/authorizationUpdate
Body Parameters
- authorizationUpdateobjectrequiredExample
{ "transactionID": "ABC123456", "authStatus": true, "paymentMethods": [ { "paymentType": "creditCard", "paymentMethodID": "2ljr9vxsdfew", "avsResult": "matched", "cvvResult": "matched", "cardAuthorizationCode": "12345", "cardAuthorizationDateTime": "2022-03-11T17:07:24-07:00", "sca3DSFlow": "frictionless", "sca3DSVersion": "2.2.0", "eciIndicator": "successful", "isSCASoftDecline": false, "sca3DSChallengeRequestType": "02", "sca3DSTransactionStatus": "Y", "scaAuthorizationStatus": "approve" } ] }- transactionIDstringrequiredExampleDescription
- authStatusbooleanrequiredExampleDescription
- paymentMethodsobject[]Example
[ { "paymentType": "creditCard", "paymentMethodID": "2ljr9vxsdfew", "avsResult": "matched", "cvvResult": "matched", "cardAuthorizationCode": "12345", "cardAuthorizationDateTime": "2022-03-11T17:07:24-07:00", "sca3DSFlow": "frictionless", "sca3DSVersion": "2.2.0", "eciIndicator": "successful", "isSCASoftDecline": false, "sca3DSChallengeRequestType": "02", "sca3DSTransactionStatus": "Y", "scaAuthorizationStatus": "approve" } ]- paymentTypestring<bankAccount | cash | check | creditCard | cryptoCurrency | digitalWallet | electronicFundTransfer | giftCard | invoice | loan | loyaltyPoints | moneyOrder | secCard | storeCredit | thirdParty | voucher>ExampleAllowedbankAccountcashcheckcreditCardcryptoCurrencydigitalWalletelectronicFundTransfergiftCardinvoiceloanloyaltyPointsmoneyOrdersecCardstoreCreditthirdPartyvoucher
- paymentMethodIDstringExample
- avsResultstring<matched | partialMatch | notMatched | notChecked | systemError | other>ExampleAllowedmatchedpartialMatchnotMatchednotCheckedsystemErrorother
- cvvResultstring<matched | notMatched>ExampleAllowedmatchednotMatched
- cardAuthorizationCodestringExample
- cardAuthorizationDateTimestring<date-time>ExampleFormatdate-time
- postAuthorizationRejectReasonstring<creditReject | fraudReject | otherReject>ExampleAllowedcreditRejectfraudRejectotherReject
- totalFailedAttemptsintegerMinimum0
- eciIndicatorstring<successful | unsuccessfulOrNotAttempted | attemptedButNotCompleted | other>ExampleAllowedsuccessfulunsuccessfulOrNotAttemptedattemptedButNotCompletedother
- isSCASoftDeclineboolean
- sca3DSFlowstring<challenge | frictionless | dataOnly>ExampleAllowedchallengefrictionlessdataOnly
- sca3DSVersionstringExample
- sca3DSChallengeRequestTypestring<02 | 03 | 04 | 05 | 06 | 10 | 11>ExampleAllowed02030405061011
- sca3DSTransactionStatusstring<Y | N | U | A | I>ExampleAllowedYNUAI
- scaAuthorizationStatusstring<approve | decline>ExampleAllowedapprovedecline
- scaAuthorizationErrorstring<decline | fraudReject | insufficientFunds | invalidCard | incorrectInformation | lostOrStolen | withdrawalAmountExceeded | technicalError | other>ExampleAlloweddeclinefraudRejectinsufficientFundsinvalidCardincorrectInformationlostOrStolenwithdrawalAmountExceededtechnicalErrorother
Responses
200
- notScoredResultDescription
- eventIDstring
- messagesapiMessages
- errorapiMessage[]
- codestringrequiredExampleDescription
- messagestringrequiredExampleDescription
- fieldstringExampleDescription
- detailsmap<string, string>Description
- warningapiMessage[]
- codestringrequiredExampleDescription
- messagestringrequiredExampleDescription
- fieldstringExampleDescription
- detailsmap<string, string>Description
- infoapiMessage[]
- codestringrequiredExampleDescription
- messagestringrequiredExampleDescription
- fieldstringExampleDescription
- detailsmap<string, string>Description
- statusbooleanrequiredDescription
400
- validationFailedErrorDescription
- errorCodeintegerExampleDescription
- errorMessagestringExampleDescription
- errorsstring[]Example
[ "Missing required field: transactionID" ]
Description
401
- notAuthorizedErrorDescription
- errorCodeintegerExampleDescription
- errorMessagestringExampleDescription
429
- rateLimitErrorDescription
- errorCodeintegerExampleDescription
- errorMessagestringExampleDescription
500
- internalServerErrorDescription
- errorCodeintegerExampleDescription
- errorMessagestringExampleDescription
curl
curl --request POST \
--url https://api.accertify.net/api/v1/unified-risk/ticketing/authorizationUpdate \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"transactionID": "ABC123456",
"authStatus": true
}'javascript
var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");
var raw = JSON.stringify({
"transactionID": "ABC123456",
"authStatus": true
});
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://api.accertify.net/api/v1/unified-risk/ticketing/authorizationUpdate", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));ruby
require "uri"
require "json"
require "net/http"
url = URI("https://api.accertify.net/api/v1/unified-risk/ticketing/authorizationUpdate")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request.body = JSON.dump({
"transactionID": "ABC123456",
"authStatus": true
})
response = https.request(request)
puts response.read_body
python
import requests
import json
url = "https://api.accertify.net/api/v1/unified-risk/ticketing/authorizationUpdate"
payload = json.dumps({
"transactionID": "ABC123456",
"authStatus": True
})
headers = {
'accept': 'application/json',
'content-type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
200
// Successful response.
{
"eventID": "",
"messages": {
"error": [
{
"code": "FIELD_REQUIRED_MISSING",
"message": "transactionID is required and was not provided",
"field": "transactionID",
"details": ""
}
],
"warning": [
{
"code": "FIELD_REQUIRED_MISSING",
"message": "transactionID is required and was not provided",
"field": "transactionID",
"details": ""
}
],
"info": [
{
"code": "FIELD_REQUIRED_MISSING",
"message": "transactionID is required and was not provided",
"field": "transactionID",
"details": ""
}
]
},
"status": false
}400
// Error response for invalid or missing request inputs. Returned when one or more required fields are absent or fail validation.
{
"errorCode": 400,
"errorMessage": "Validation Failed",
"errors": [
""
]
}401
// Error response for authentication or authorization failures. Returned when credentials are invalid or the authenticated user has no matching API configuration for this endpoint.
{
"errorCode": 401,
"errorMessage": "Not Authorized"
}429
// Error response when the request rate limit has been exceeded for the API user or API configuration.
{
"errorCode": 429,
"errorMessage": "Rate Limit Exceeded"
}500
// Error response when the request cannot be processed due to an unexpected internal error.
{
"errorCode": 500,
"errorMessage": "Internal Server Error"
}