IPIN: denied_auth_invalid_pin

webhook

denied_auth_invalid_pin

A transaction was denied because the PIN was invalid or the PIN retry limit was reached. Available balance has not changed.

Trigger — One of these things happens:
- You or Galileo deny an authorization request because of an invalid PIN.
- The PIN retry limit is reached.
Processes — These processes contain the event trigger:
- SoFi Tech Solutions receives one of these messages from a card network:
  - Preauthorization request
  - Authorization request

Payload

act_type

string

See Activity Type for possible values.

amount

string

Amount of the transaction. Unsigned.

amount_sign

string

Indicates whether the value in amount is positive or negative: hyphen (-) for negative or plus sign (+) for positive. Legacy field: sign_amount.

amti

string

AAAU only. Amount of the transaction in cents. The amount is signed: - to debit the account and + to credit the account.

association_name

string

Acquirer Reference Number (ARN) from the linked adjustment record.

auth_id

string

System-generated ID for the authorization request. This ID is unique only per subnetwork.

auth_id_response

string

Authorization identification response, a numeric code that SoFi Tech Solutions returns to a merchant to verify that the transaction was authorized. DE038.

auth_response_code

string

See Authorization Response Codes for possible values.

auth_tran_type

string

Based on DE003, processing code. Type of authorization request. See Authorization types for possible values.

auth_trans_data

string

Additional transaction JSON data associated with the authorization record.

avail_cash

string

For debit accounts, the available_balance plus available overdraft.

avail_credit

string

For credit accounts, the available credit limit to spend.

available_balance

string

Amount available to spend at the time of the event. Legacy field: balance.

available_balance_ts

string

Timestamp when available_balance was captured. Format: YYYY-MM-DD hh:mm:ss.ssssss

balance_id

string

The balance ID, also called the galileo_account_number. Legacy field: account_id.

billing_amount

string

Amount to be billed in the currency of the cardholder account (DE006). Legacy field: billing_amt.

billing_curr_code

string

Currency code for billing_amount (DE051).

bookkeeping_auth_id

string

An interim auth_id that is present only when a transaction is being cleared incrementally. See Incremental clearing in the Card Transaction Examples guide for details.

cad

string

System-generated card ID, which has a 1:1 relationship with the PAN. Legacy field: card_id.

card_not_present

string

AAAU only. Y if the physical card was not present at the transaction (card-not-present); N otherwise.

cashback_amount

string

Amount of the transaction that is cashback instead of purchase. This amount is included in amount.

ch_group_id

string

Corporate Hierarchy group identifier.

client_id

string

ID for the customer record.

credit_balance

string

For credit accounts, the total amount of unpaid purchases and advances.

credit_ind

string

Whether a PIN was input at the point of sale: Y (no PIN was input) or N (a PIN was input) or None (not a card transaction, or not processed as a card transaction).

currency_code

string

ISO 4217 numeric currency code for amount (the cardholder account currency). Legacy fields: cur_code, currency.

currency_rate_id

string

Identifier for the currency conversion rate that was applied to this transaction when it is not domestic relative to the card account.

de003

string

Raw contents of DE003, processing code. See DE003 Codes for possible values.

de022

string

Raw contents of DE022, POS entry mode. See DE022 Codes for possible values.

de11

string

AAAU only. System Trace Audit Number (STAN). A number that a message initiator assigns to uniquely identify a transaction.

domestic

string

Whether this is a domestic transaction. Y is domestic; N is international.

ds_transaction_id

string

BAUT only, Mastercard only. Directory server transaction ID. A UUID that the merchant passes in the authorization request to link 3DS authentication and authorization data. Mastercard DE048SE66SF2.

event_ts

string

Timestamp when the message was ingested by SoFi Tech Solutions (Mountain Standard Time). Format: "YYYY-MM-DD hh:mm:ss MST". Legacy fields: timestamp, tran_timestamp.

external_account_id

string

User-supplied identifier to link to an external system.

fee_amt

string

Program transaction fee.

financial_network_code

string

The financial bank card product or branding of the card. DE063SE1. Valid values: CI (Cirrus), MC (Mastercard credit), MD (Debit Mastercard), MS (Maestro), PL (Visa Plus), PV (Private Label), VI (Visa).

fund_prn

string

The PRN of the RTF or Corporate Credit funding account that is associated with this spending account. Legacy field: fund_pmt_ref_no.

local_currency_amount

string

Amount of the transaction in the currency at the point of sale (DE004). No fees or upcharges included. Legacy fields: local_amount, local_amt.

local_currency_code

string

Currency code for local_currency_amount (DE049). Legacy fields: local_curr_code, local_currency.

local_surcharge_amt

string

The surcharge amount (DE028) added by the merchant or ATM operator. This amount is included in amount.

mc_installment_pmt_data

string

Contents of DE112 SE7. See MSI Installments data to interpret the code.

mc_promotion_code

string

Contents of DE048 SE95. See MSI Installments data to interpret the code.

mcc

string

Merchant category code (DE018).

merchant

string

Concatenation of merchant_name and merchant_location.

merchant_location

string

Merchant city and state (from remaining part of ISO DE043). Legacy field: merch_loc.

merchant_name

string

Merchant name (first 22 characters of DE043). Should not be used for matching; instead, use merchant_number. Legacy field: merch_name.

merchant_number

string

Merchant number (DE042). Legacy field: merch_num.

merchant_postal_code

string

The postal code for the merchant.

method

string

Event category. Indicates the type of event.

msg_event_id

string

Unique system-generated identifier for this message.

msg_id

string

The four-letter code to identify this event.

msg_type_flag

string

Message type flag from the source auth record indicating the type of card network message.

network

string

See Events Network Codes for possible values.

original_auth_id

string

The auth_id of the previous authorization in a sequence. For completion, this is the auth_id of the preauthorization. For a reversal, this is the auth_id of the transaction that is being reversed. For an incremental sequence, this is the auth_id of the previous authorization in the sequence.

original_incremental_id

string

The auth_id of the first authorization in an incremental sequence.

otype

string

See Transaction Types for possible values.

prn

string

SoFi Tech Solutions 12-digit payment reference number (PRN) for the account. Legacy field: pmt_ref_no.

proc_code

string

Processing code, derived from positions 1-2 of DE003. The type of transaction being processed.

prod_id

string

The product ID of the account.

prog_id

string

The program ID of the account.

response_reasons

string

Pipe-delimited list of factors that were calculated for response_code.

ret_ref_num

string

Retrieval reference number (DE037), assigned by the acquirer.

return_code

string

ACH or network return code. See ACH Return Codes for possible values.

risk_score

string

Risk score provided by the network. Higher numbers mean higher risk.

rules_results

string

DENY-type rules as calculated by the SoFi Tech Solutions integrated fraud-detection processes. Legacy field: rules_denied.

settle_currency_amount

string

Amount of the settlement in the settlement currency.

settle_currency_code

string

ISO 4217 numeric currency code for the settlement amount. Legacy field: settle_currency.

source

string

Source system or identifier that generated this event.

terminal_id

string

Terminal identifier (DE041) for the point-of-sale device.

tlid

string

Mastercard only. Transaction link identifier. An identifier that Mastercard generates for every original transaction. DE105SF1.

token_id

string

Unique identifier for the token, provided by the card network. Called "Token Unique Reference" (TUR) by Mastercard and "Token Reference ID" by Visa.

token_requester

string

token_requester_id

string

Identifier for "token_requester".

token_type

string

Name of token requester.

type

string

The name of this event: "denied_auth_invalid_pin"

user_data

string

Populated according to your use case and needs by arrangement with SoFi Tech Solutions.

visa_trans_id

string

Contents of Field 62.2: Transaction Identifier (bitmap format). This Visa-generated transaction ID is unique for each original authorization and financial request.

Loading…