Auth Stream Access RequestCopy Pagewbhk card_authorization.approval_requestAuth Stream Access RequestPayloadevent_typeconstenumrequiredcard_authorization.approval_requestcard_authorization.approval_requestAllowed:card_authorization.approval_requestmerchantobjectrequiredMerchant information including full location details.Transaction Merchant objectservice_locationnullService Locationrequiredavsobjectrequiredavs objectcardobjectrequiredCard object in ASAcard objectcardholder_authenticationobjectCardholder Authentication objectposobjectpos objectamountint64requireddeprecatedDeprecated, use amounts. Authorization amount of the transaction (in cents), including any acquirer fees. The contents of this field are identical to authorization_amount.acquirer_feeint64requiredFee (in cents) assessed by the merchant and paid for by the cardholder. Will be zero if no fee is assessed. Rebates may be transmitted as a negative value to indicate credited fees.authorization_amountint64requireddeprecatedDeprecated, use amounts. The base transaction amount (in cents) plus the acquirer fee field. This is the amount the issuer should authorize against unless the issuer is paying the acquirer fee on behalf of the cardholder.cardholder_currencystringrequireddeprecatedDeprecated, use amounts. 3-character alphabetic ISO 4217 code for cardholder's billing currency.cash_amountint64requiredThe portion of the transaction requested as cash back by the cardholder, and does not include any acquirer fees. The amount field includes the purchase amount, the requested cash back amount, and any acquirer fees. If no cash back was requested, the value of this field will be 0, and the field will always be present.cashbackint64Deprecated, use cash_amount.token_infoobject | nullToken Info object | nullttldate-timeDeprecated: approximate time-to-live for the authorization.conversion_ratenumberdeprecatedDeprecated, use amounts. If the transaction was requested in a currency other than the settlement currency, this field will be populated to indicate the rate used to translate the merchant_amount to the amount (i.e., merchant_amount x conversion_rate = amount). Note that the merchant_amount is in the local currency and the amount is in the settlement currency.createddate-timerequiredDate and time when the transaction first occurred in UTC.merchant_amountint64requireddeprecatedDeprecated, use amounts. The amount that the merchant will receive, denominated in merchant_currency and in the smallest currency unit. Note the amount includes acquirer_fee, similar to authorization_amount. It will be different from authorization_amount if the merchant is taking payment in a different currency.merchant_currencystringrequireddeprecated3-character alphabetic ISO 4217 code for the local currency of the transaction.networkstringenumCard network of the authorization.AMEXINTERLINKMAESTROMASTERCARDUNKNOWNVISAAllowed:AMEXINTERLINKMAESTROMASTERCARDUNKNOWNVISAnetwork_risk_scoreinteger | nullNetwork-provided score assessing risk level associated with a given authorization. Scores are on a range of 0-999, with 0 representing the lowest risk and 999 representing the highest risk. For Visa transactions, where the raw score has a range of 0-99, Lithic will normalize the score by multiplying the raw score by 10x.settled_amountint64requireddeprecatedDeprecated, use amounts. Amount (in cents) of the transaction that has been settled, including any acquirer fees.amountsobjectrequiredStructured amounts for this authorization. The cardholder and merchant amounts reflect the original network authorization values. For programs with hold adjustments enabled (e.g., automated fuel dispensers or tipping MCCs), the hold amount may exceed the cardholder and merchant amounts to account for anticipated final transaction amounts such as tips or fuel fill-upsamounts objectstatusstringenumrequiredThe type of authorization request that this request is for. Note that CREDIT_AUTHORIZATION and FINANCIAL_CREDIT_AUTHORIZATION is only available to users with credit decisioning via ASA enabled.AUTHORIZATIONCREDIT_AUTHORIZATIONFINANCIAL_AUTHORIZATIONFINANCIAL_CREDIT_AUTHORIZATIONBALANCE_INQUIRYAllowed:AUTHORIZATIONCREDIT_AUTHORIZATIONFINANCIAL_AUTHORIZATIONFINANCIAL_CREDIT_AUTHORIZATIONBALANCE_INQUIRYtokenuuidrequiredThe provisional transaction group uuid associated with the authorizationevent_tokenuuidThe event token associated with the authorization. This field is only set for programs enrolled into the beta.fleet_infoobject | nullOptional Object containing information if the Card is a part of a Fleet managed programFleet Info object | nullnetwork_specific_dataobject | nullContains raw data provided by the card network, including attributes that provide further context about the authorization. If populated by the network, data is organized by Lithic and passed through without further modification. Please consult the official network documentation for more details about these values and how to use them. This object is only available to certain programs- contact your Customer Success Manager to discuss enabling access.Network Specific Data object | nullaccount_typestring | nullenumThe selected account type for applicable ATM transactions such as cash withdrawals, deposits, or balance inquiries.DEFAULTCHECKINGSAVINGSCREDIT_CARDnullAllowed:DEFAULTCHECKINGSAVINGSCREDIT_CARDnulltransaction_initiatorstringenumrequiredThe entity that initiated the transaction.CARDHOLDERMERCHANTUNKNOWNAllowed:CARDHOLDERMERCHANTUNKNOWNlatest_challengeobjectThe latest Authorization Challenge that was issued to the cardholder for this merchant.latest_challenge objectHeaderswebhook-iduuidWebhook IDwebhook-timestampintegerUnix timestamp used for HMAC verificationwebhook-signaturestringA list of HMAC signatures encoded in Base64 and separated by spaces. Can contain multiple HMAC signatures as a result of key rotation.Responses 200Return a HTTP 200 status to indicate that the ASA responder was able to handle the request. 5XXReturn a HTTP 5XX response to indicate processing failure. This will cause Lithic to immediately retry the request once.Updated about 18 hours ago
