Authorization events
During the authorization workflow, the Pismo platform generates events that allow you to verify transaction status and other information. For information about using these events to map the lifecycle of an authorization, see Linking authorization events.
The Network authorization event is the primary event for verifying an authorization. However, you should consume all the authorization events to make sure that you don't miss anything.
The Full and Zero balance workflows detail the events that Full balance and Zero balance issuers will see. They are similar, but slightly different.
Authorization event characteristics
The Pismo platform generates events related to specific authorization messages received from the card network. For any given transaction, Pismo might or might not generate all of the events, depending on the transaction life cycle. Also, various steps in the authorization process might issue the same event, so an event could be issued many times for one transaction.
Base contract
Each event contains a common set of fields, (base contract) such as event_id, domain, and event_type. The aforementioned fields uniquely identify each event. The data field contains data unique to each event.
Authorization event types
The Pismo platform supports the following authorization event types:
- Network authorization ISO8583 message
- Network authorization
- Card network authorization return
- Timeline
- Clearing/Base II (raw messages)
These events are described in the following sections.
Network authorization ISO8583 message event
Domain: networktransactions
Type:
This event represents the raw message received from the card network in the authorization workflow. You can use it to verify all non-sensitive data received for a specific message (that is, messages other than Clearing/Base II messages). The Pismo platform issues an iso8583 event after parsing the message and removing any sensitive data from the payload. The event is not issued if an error or timeout prevents the message from reaching the platform.
An iso8583 event payload contains a base contract with any custom data included in the data field.
Zero balance
This is the one authorization event Zero balance issuers do not get, as they get the raw message as part of what is sent when Pismo calls the issuer's webhook as detailed in Steps 4 and 5 in the Full and Zero balance workflows.
You can use the base contract's cid field to relate this event to other related events. For more details, visit Linking events in an authorization workflow.
Message type indicator field
You can identify what kind of message is associated with an event using the
mtifield of the message. Here are a few examples of values formtiand the type of message each one represents.
- 0100 - Authorization request
- 0120 - Authorization advice
- 0400 - Reversal request
For more information, see message type indicator
In the message field, there's a JSON payload representing all the fields present in the message received from the card network. The payload does not include fields for sensitive messages. The message field does not have a fixed payload, because it varies depending on the network. To identify each field present in the message, you need to look up the field in the network manual.
iso8583-message event examples
The following iso8583-message event examples illustrate the fields coming from different card networks. The content varies according to the request being processed, where some fields may or may not be present. Refer to the network specification to find all possible fields.
Mastercard example - iso8583-message event
{
"event_id": "[valid-uuid]",
"domain": "networktransactions",
"event_type": "iso8583-message",
"schema_version": "1",
"org_id": "[tenant]",
"cid": "[valid-uuid-correlation-id]",
"data": {
"card_hash": "[card-hash]",
"caller": "Mastercard",
"mti": "0100",
"message": {
"de2_primary_account_number": "[card-hash]",
"de3_processing_code": {
"sf1_cardholder_transaction_type_code": "00",
"sf2_cardholder_from_account_type_code": "30",
"sf3_cardholder_to_account_type_code": "00"
},
"de4_amount_transaction": "000000000750",
"de5_amount_settlement": "000000000143",
"de6_amount_cardholder_billing": "000000000750",
"de7_tranmission_date_and_time": {
"sf1_date": "1208",
"sf2_time": "133633"
},
"de9_conversion_rate_settlement": {
"sf1_decimal_indicator": "7",
"sf2_conversion_rate": "1906667"
},
"de10_conversion_rate_cardholder_billing": {
"sf1_decimal_indicator": "6",
"sf2_cardholderbilling_conversion_rate": "1000000"
},
"de11_stan": "268820",
"de12_time_local_transaction": "103633",
"de13_date_local_transaction": "1208",
"de14_date_expiration": "2811",
"de15_date_settlement": "1208",
"de16_date_conversion": "1207",
"de18_merchant_type": "5814",
"de22_pos_entry_mode": {
"sf1_pos_terminal_pan_entry_mode": "07",
"sf2_pos_terminal_pin_entry_mode": "1"
},
"de23_card_sequence_number": "000",
"de28_amount_transaction_fee": {},
"de29_amount_settlement_fee": {},
"de30_amount_transaction_processing_fee": {},
"de31_amount_settlement_processing_fee": {},
"de32_acquiring_institution_id_code": "012088",
"de33_forwarding_institution_id_code": "012088",
"de37_retrieval_reference_number": {
"sf1_transaction_date_and_initiator_discretionary_data": "7777777",
"sf2_terminal_transaction_number": "55555"
},
"de41_card_acceptor_terminal_id": "00000001",
"de42_card_acceptor_id_code": "033350555550001",
"de43_card_acceptor_name_location_for_all_transactions": {
"sf1_card_acceptor_name": "MERCHANT NAME ",
"sf3_card_acceptor_city": "MERCHANT CITY ",
"sf5_card_acceptor_state_or_country_code": "BRA"
},
"de48_additional_data_private_user": {
"se11_key_exchange_block_data": {},
"se13_mastercard_hosted_mobile_phone_top_up_request_data": {},
"se15_authorization_system_advice_date_and_time": {},
"se18_service_parameters": {},
"se23_payment_initiation_channel": {},
"se25_mastercard_cash_program_data": {},
"se26_wallet_program_data": {},
"se33_pan_mapping_file_information": {},
"se34_atc_information": {},
"se36_visa_mmv": {},
"se37_additional_merchant_data": {},
"se40_eletronic_commerce_merchant_cardholder_certificate_serial_number": {},
"se41_eletronic_commercer_certificate_qualifying_information": {},
"se42_eletronic_commerce_indicator": {},
"se43_ucaf": {},
"se48_mobile_program_indicator": {},
"se49_time_validation_information": {},
"se51_merchant_on_behalf_services": {},
"se55_merchant_fraud_scoring_data": {},
"se56_security_services_additional_data_for_issuers": [
{
"sf1_security_services_indicator": "AQV",
"sf2_security_services_data": "000"
},
{
"sf1_security_services_indicator": "AQS",
"sf2_security_services_data": "000"
},
{
"sf1_security_services_indicator": "AQF",
"sf2_security_services_data": "000"
}
],
"se57_security_services_additional_data_for_acquirers": {},
"se58_atm_additional_data": {},
"se61_pos_data_extended_condition_codes": {
"sf1_partial_approval_terminal_support_indicator": "0",
"sf2_purchase_amount_only_terminal_support_indicator": "0",
"sf3_realtime_substantiation_indicator": "0",
"sf4_merchant_transaction_fraud_scoring_indicator": "0",
"sf5_final_authorization_indicator": "1"
},
"se64_transit_program": {},
"se65_terminal_compliant_indicator": {},
"se66_authentication_data": {},
"se67_money_send_information": {},
"se71_onbehalf_services": [
{
"sf1_ob_service": "18",
"sf2_onbehalf_result1": "C",
"sf3_onbehalf_result2": " "
}
],
"se74_additional_processing_information": {},
"se75_fraud_scoring_data": {
"sf1_fraud_score": "009",
"sf2_score_reason_code": "90",
"sf3_rules_score": "009",
"sf4_rules_reason_code1": "90",
"sf5_rules_reason_code2": "00"
},
"se78_payment_service_indicator": {},
"se79_chip_cvr_or_tvr_bit_error_results": {},
"se87_card_validation_code_result_or_cvv2": "M",
"se93_fleet_card_id_request_data": {}
},
"de49_currency_code_transaction": "986",
"de50_currency_code_settlement": "840",
"de51_currency_code_cardholder_billing": "986",
"de55_integrated_circuit_card": {
"sf2_cryptogram_information_data": "80",
"sf3_issuer_application_data": "0333B04005550000000000000000000000FF",
"sf5_terminal_verification_result": "0000008001",
"sf6_transaction_date": "221208",
"sf7_transaction_type": "00",
"sf8_amount_authorized": "000000000750",
"sf9_transaction_currency_code": "0986",
"sf10_application_interchange_profile": "1980",
"sf11_terminal_country_code": "0076",
"sf12_cardholder_verification_method": "1F0302",
"sf13_terminal_capabilities": "E008E8",
"sf15_amount_other": "000000000000",
"sf23_application_transaction_counter": "001E"
},
"de60_advice_reason_code": {},
"de61_pos_data": {
"sf1_pos_terminal_attendance": "0",
"sf2_reserved_for_future_use": "0",
"sf3_pos_terminal_location": "0",
"sf4_pos_cardholder_presence": "0",
"sf5_pos_card_presence": "0",
"sf6_pos_card_capture_capabilities": "0",
"sf7_pos_transaction_status": "0",
"sf8_pos_transaction_security": "0",
"sf9_reserved_for_future_use": "0",
"sf10_cardholder_activated_terminal_level": "0",
"sf11_pos_card_data_terminal_input_capability_indicator": "3",
"sf12_pos_authorization_life_cycle": "00",
"sf13_pos_country_code_or_submerchant": "076",
"sf14_postal_code_or_submerchant": "0555551000"
},
"de63_network_data": {
"sf1_financial_network_code": "MBK",
"sf2_banknet_reference_number": "ABCXYZ"
},
"de90_original_data_elements": {},
"de94_service_indicator": {},
"de95_replacement_amounts": {},
"de97_amount_net_settlement": {},
"de112_additional_data_national_use": {},
"de120_record_data": {},
"de124_member_defined_data": {}
}
}
}
Visa example - iso8583-message event
{
"event_id": "[valid-uuid]",
"domain": "networktransactions",
"event_type": "iso8583-message",
"schema_version": "1",
"org_id": "[tenant]",
"cid": "[valid-uuid-correlation-id]",
"timestamp": "2022-12-08T10:00:00.707Z",
"data": {
"card_hash": "[card-hash]",
"caller": "Visa",
"mti": "0100",
"message": {
"f2_primary_account_number": "[card-hash]",
"f3_processing_code": "002000",
"f4_amount_transaction": "000000000200",
"f6_amount_cardholder_billing": "000000000039",
"f7_transmission_date_and_time": "1208135000",
"f10_conversion_rate_cardholder_billing": "71950000",
"f11_stan": "777777",
"f14_date_expiration": "2710",
"f15_date_liquidation": "1209",
"f18_merchant_type": "5411",
"f19_acquiring_institution_country_code": "0076",
"f22_pos_entry_mode": "0510",
"f23_card_sequence_number": "0000",
"f25_pos_condition_code": "00",
"f32_acquiring_institution_id_code": "417939",
"f34_electronic_ecommerce_data": {
"sf01_authentication_data": {}
},
"f37_retrieval_reference_number": "123456789012",
"f41_card_acceptor_terminal_id": "PGWD99FE",
"f42_card_acceptor_id_code": "000000091075999",
"f43_card_acceptor_location": "Merchant Name Merchant City Country",
"f48_additional_data_private": {},
"f49_currency_code_transaction": "0986",
"f51_currency_code_cardholder_billing": "0840",
"f55_integrated_circuit_card": {
"sf3_issuer_application_data": "06033304B99002",
"sf5_terminal_verification_result": "0080008000",
"sf6_transaction_date": "221208",
"sf7_transaction_type": "00",
"sf8_amount_authorized": "000000000200",
"sf9_transaction_currency_code": "0986",
"sf10_application_interchange_profile": "3800",
"sf11_terminal_country_code": "0076",
"sf13_terminal_capabilities": "E0F0C8",
"sf15_amount_other": "000000000000",
"sf23_application_transaction_counter": "0050"
},
"f56_payment_account_reference_data": {},
"f59_national_point_of_service_geographic_data": "0000099902200",
"f60_additional_pos_data": "05000010",
"f62_custom_payment_services": {
"sf2_transaction_identifier": "123456789012345"
},
"f63_private_use": {
"sf1_network_id": "0002"
},
"f104_transaction_description_transaction_specific_data": {
"sf5d_installments_data": {},
"sf69_payment_format": {},
"sf67_national_payment_format": {}
},
"f117_national_use": {
"usage_6_argentina_agro": {}
},
"f123_verification_data": {
"token_data": {},
"address_verification_data": {},
"activation_verification_data": {}
},
"f125_supporting_information_data": {
"token_device": {},
"wallet_provider": {}
},
"f126_visa_private_use_fields": {}
}
}
Tecban example - iso8583-message event
{
"event_id": "[valid-uuid]",
"domain": "networktransactions",
"event_type": "iso8583-message",
"schema_version": "1",
"org_id": "[tenant]",
"cid": "[valid-uuid-correlation-id]",
"timestamp": "2022-12-09T10:00:00.421Z",
"data": {
"card_hash": "[card-hash]",
"caller": "tecban",
"mti": "0200",
"message": {
"de2_primary_account_number": "[card-hash]",
"de3_processing_code": {
"sf1_cardholder_transaction_type_code": "01",
"sf2_cardholder_from_account_type_code": "20",
"sf3_cardholder_to_account_type_code": "00"
},
"de4_amount_transaction": "000000100000",
"de7_tranmission_date_and_time": {
"sf1_date": "1209",
"sf2_time": "150000"
},
"de11_nsu": "999999",
"de12_time_local_transaction": "120000",
"de13_date_local_transaction": "1209",
"de15_date_settlement": "1209",
"de22_pos_entry_mode": {
"sf1_pos_terminal_pan_entry_mode": "05",
"sf2_pos_terminal_pin_entry_mode": "1"
},
"de23_card_sequence_number": "000",
"de32_institution_id_code": "00088888888",
"de37_retrieval_reference_number": "123456789012",
"de41_card_acceptor_terminal_id": "00055555",
"de42_card_acceptor_id_code": "000000007777777",
"de49_currency_code_transaction": "076",
"de55_integrated_circuit_card": {
"sf3_issuer_application_data": "0333B00009990000000000000000000000FF",
"sf5_terminal_verification_result": "8000040000",
"sf6_transaction_date": "221209",
"sf7_transaction_type": "01",
"sf8_amount_authorized": "000000100000",
"sf9_transaction_currency_code": "0986",
"sf10_application_interchange_profile": "3900",
"sf11_terminal_country_code": "0076",
"sf12_cardholder_verification_method": "020300",
"sf13_terminal_capabilities": "6040C0",
"sf15_amount_other": "000000000000",
"sf23_application_transaction_counter": "0095"
},
"de61_pos_data": "B88888888",
"de127_response_nsu": "000999999"
}
}
}
Network authorization event
Domain: networktransactions
Type:
This event represents an authorization action. All authorization actions generate a Network authorization event. The Pismo platform issues the event after the message is processed and a decision is made about the action to take.
The enum field authorization_category identifies the event action such as authorization or confirmation. An operation can issue one or more Network authorization events. Each event identifies an action performed during the operation. For example, if an operation is authorized, confirmed, and then canceled, three Network authorization events are issued with the categories AUTHORIZATION, CONFIRMATION, and CANCELLATION, respectively.
The Network authorization event payload includes the base contract and the data field, which contains the event details in JSON format.
A Network authorization event can be used as a base point to link other events issued in the authorization workflow. The Pismo platform sends this event for all actions related to an authorization record. The event contains all the information you need to identify the relationship between events, including the authorization id (authorization_id), correlation id (cid), and other values. For more details, visit Linking events in an authorization workflow.
Full and Zero balance
A Network authorization event is issued in both Full and Zero balance workflows. See step 6 in the Full and Zero balance workflows.
Card network authorization return event
Domain: networktransactions
Type:
This event represents the response the Pismo platform sends to the card network in the online workflow for one operation. The platform issues it immediately before it sends the same response to the network. It can be used to verify that the authorization event emitted for this operation has the same result as the one sent to the network.
It's possible that the Pismo platform will approve an operation, issuing a Network authorization event, but an error in processing will occur after the approval. In this case, the online response event will show a declined response while the Network Authorization event will show an approved response. The platform will notify the cardholder that the transaction was declined for an unknown reason and that they should try again. You can use both events to identify the error in the processing.
The platform uses the Card network authorization return event to reconcile the previously saved operation status against the response sent to the network. If the two values are different, it indicates that an error occurred between the time when the decision was made and when the decision was sent to the network. In this case, an appropriate action is taken. For example, an authorization might be canceled, or the authorization team might be alerted so that they can fix the inconsistency.
The event payloadcontains the base contract and the data field contents in JSON format.
Full and Zero balance
A Card network authorization return event is issued in both Full and Zero balance workflows. See step 6 in the Full and Zero balance workflows.
Timeline events
The platform generates timeline events at the same time as the Network authorization event and they contain similar information. You can use the information from both events to obtain all information about the authorization, but the Network authorization event is the primary source.
Domain: timeline
Types:
- authorization_authorize
- authorization_cancellation
- authorization_cancellation_refusal
- authorization_cancellation_reversal
- authorization_partial_cancellation
- authorization-refusal
- authorization-referral
- authorization_replacement
- authorization_incremental
- confirmation-authorize
- confirmation-cancellation
- confirmation_replacement
Timeline events are not issued if you use a Zero balance workflow, because you control the authorization life cycle.
Clearing/Base II events
Clearing/Base II events are emitted in two domains – networktransactions and authorization.
Domain: networktransactions
Types:
- clearing – This is the recommended Clearing/Base II event to use. In addition to raw data, it contains useful information to identify the account, card, program, file type, and network.
Domain: authorization
Types:
A Clearing/Base II event should be used to verify all non-sensitive data received for Clearing/Base II messages. These events have the same purpose as iso8583 events, since they also represent raw messages received from the card network. The Pismo platform issues a Clearing/Base II event after parsing the message and removing any sensitive data from the payload.
To identify each field present in the message, you need to look up the field in the network manual. The field names are the same as in the manual.
Full vs Zero balance
Clearing/Base II events are issued in both Full and Zero balance workflows.
Clearing event examples
The following clearing event examples show the fields from different card networks. The content varies according to the request being processed, where some fields may or may not be present. Refer to the network specification to find all possible fields.
Mastercard T112 dual message example - clearing event
{
"event_id": "[valid-uuid]",
"domain": "networktransactions",
"event_type": "clearing",
"schema_version": "1",
"org_id": "[tenant]",
"cid": "[valid-uuid-correlation-id]",
"timestamp": "2022-12-08T11:00:00.000Z",
"data": {
"card_id": 99999,
"account_id": 88888,
"program_id": 123,
"file_type": "T112",
"network": "Mastercard",
"raw_message": {
"mti": "FIRST_PRESENTMENT",
"primaryAccountNumber": "[card-hash]",
"processingCode": {
"transactionTypeCode": "00",
"codeFromAccountTypeCode": "00",
"codeToAccountTypeCode": "00"
},
"transactionAmount": 100.00,
"reconciliationAmount": "000000010000",
"cardholderBillingAmount": "000000010000",
"reconciliationConversionRate": "61000000",
"cardholderBillingConversionRate": "61000000",
"localTransactionDateTime": {
"date": "2022-12-07T03:00:00+0000",
"time": "1970-01-01T06:04:34+0000"
},
"posEntryMode": "B90550799001",
"cardSequenceNumber": "000",
"functionCode": 200,
"cardAcceptorBusinessCode": "6300",
"acquirerReferenceDate": {
"mixedUse": "0",
"acquirersBin": "548087",
"julianProcessingDate": "2342",
"acquirersSequenceNumber": "97777199999",
"checkDigitNumeric": "2"
},
"forwardingInstitutionIdCode": "006207",
"approvalCode": "ABC123",
"cardAcceptorIdCode": "099990167 ",
"cardAcceptorNameLocation": "MERCHANTNAME\\\\MERCHANTADDRESS\\\\CITY\\\\POSTALCODE SP BRA",
"additionalData": {
"p0002": "MBK",
"p0003": "MBK",
"p0015": "2212061",
"terminalType": "CT6",
"p0052": "210",
"transactionFeeAmounts": [
{
"feeTypeCode": "00",
"feeProcessingCode": "29",
"feeSettlementIndicator": "01",
"feeCurrencyCode": "986",
"feeAmount": "000000000080",
"feeReconciliationCurrencyCode": "986",
"feeReconciliationAmount": "000000000080"
}
],
"currencyExponents": "9862",
"businessActivity": "MCC4082000HU221209940MBKNNNNNNN",
"p0159": "99999 0000000099999 1LA00098610N2212070422120701",
"settlementIndicator": "M",
"p0177": "N ",
"originatingMessageFormat": "2"
},
"transactionCurrencyCode": "986",
"reconcilliationCurrencyCode": "986",
"cardholderBillingCurrencyCode": "986",
"transactionLifeCycleId": " MBK9999991207 ",
"messageNumber": "00025718",
"transactionDestinationInstitutionIdCode": "[card-hash]",
"transactionOriginatorInstitutionIdCode": "006207",
"receivingInstitutionIdCode": "099999",
"correlationId": "[valid-uuid-correlation-id]",
"orgId": "[tenant]",
"caller": "Mastercard",
"network": "Mastercard",
"authorizationCode": "ABC123",
"instituionId": "099999",
"endpoint": "[endpointId]",
"zeroBalanceUrl": null,
"clearingType": "CREDIT",
"category": null,
"origin": null,
"fileDate": "2022-12-07",
"businessActivity": {
"businessServiceArrangementTypeCode": "4",
"corporateIncentiveRatesApplyIndicator": "N",
"businessServiceIdCode": "076000",
"masterPassIncentiveIndicator": "N",
"specialsConditionsIndicator": "N",
"interchangeRateDesignator": "HU",
"rateIndicator": "N",
"accountLevelManagementAccountCategoryCode": "N",
"mastercardAssignedIdOverrideIndicator": "N",
"centralSiteBusinessDate": "221208",
"businessCycle": "04",
"cardAcceptorClassificationOverrideIndicator": "0",
"productClassOverrideIndicator": "MBK",
"cardProgramIdentifier": "MCC"
},
"settlementData": {
"settlementForeignExchangeRateClassCode": "N",
"settlementServiceTransferAgentIdCode": "99999 ",
"settlementServiceIdCode": "LA00098610",
"settlementServiceLevelCode": "3",
"settlementDate": "221207",
"reconciliationCycle": "04",
"settlementCycle": "01",
"settlementServiceTransferAgentAccount": "0000000099999 ",
"reconciliationDate": "221208"
}
}
}
}
Mastercard T464 single message example - clearing event
{
"event_id": "[valid-uuid]",
"domain": "networktransactions",
"event_type": "clearing",
"schema_version": "1",
"org_id": "[tenant]",
"cid": "[valid-uuid-correlation-id]",
"timestamp": "2022-12-08T10:00:00.761Z",
"data": {
"card_id": 99999,
"account_id": 88888,
"program_id": 123,
"file_type": "T464",
"network": "Mastercard",
"raw_message": {
"caller": "Mastercard",
"transactionTime": "010905",
"crossBorderCurrencyIndicator": "X",
"correlationId": "[valid-uuid-correlation-id]",
"currencyCodeSettlement": "986",
"authorizationId": "ABC123",
"interchangeFeeIndicator": "C",
"clearingType": "DEBIT",
"isaFeeIndicator": " ",
"traceNumberAdjustmentTrans": "000000",
"intracurrencyAgreementCode": "X986",
"posEntry": "051",
"processingCode": "002000",
"messageTypeIndicator": "FREC",
"completedAmountTransactionIndicator": "D",
"requestedAmountTransaction": "000000010000",
"processorId": "1507",
"impliedDecimalTransaction": "2",
"reconActivity": " ",
"completedAmountTransaction": "000000010000",
"zeroBalanceUrl": null,
"traceNumber": "866999",
"positiveIdIndicator": "4",
"serviceLevelIndicator": " ",
"accessFee": "00000000",
"messageNumber": "333855555",
"cashBackAmountIndicator": "D",
"recordType": "FREC",
"transactionDate": "120722",
"accessFeeIndicator": "D",
"conversionRateSettlement": "11000000",
"atmSurcharge": "N",
"responseCodeDE39": "00",
"brand": "MS2",
"orgId": "[tenant]",
"transactionDestinationInstitutionIdCode": "[card-hash]",
"crossBorderIndicator": "N",
"authorizationCode": "ABC123",
"responseCode": " ",
"cashBackAmount": "000000000000",
"network": "Mastercard",
"referenceNumber": "777777799999",
"merchantType": "5965",
"acquirerInstitutionId": "1994444073",
"pan": "[card-hash]",
"impliedDecimalSettlement": "2",
"endpoint": "[endpoint]",
"currencyCodeTransaction": "986",
"completedAmountSettlementIndicator": "D",
"institutionId": null,
"terminalId": "ABC88888 ",
"processorType": "I",
"adviceReasonCode": " ",
"completedAmountSettlement": "000000010000",
"addendums": [
{
"caller": null,
"cardIssuerInstitution": "1997777777",
"correlationId": null,
"merchantId": "340644440000000",
"orgId": null,
"account2Length": "19",
"account2To": "0000000000000000000",
"cardAcceptorCity": "Merchant City",
"clearingType": "DEBIT",
"standinTransaction": "N",
"paymentTypeIndicator": " ",
"impliedDecimalCardholderBilling": "2",
"transactionDestinationInstitutionIdCode": null,
"authorizationCode": null,
"amountIndicator": "D",
"debitMastercardOffline": "N",
"network": null,
"messageTypeIndicator": "FPST",
"processorId": "001507",
"s3Path": null,
"currencyCodeCardholderBilling": "986",
"endpoint": null,
"filler3": " ",
"account1From": "0000000000000000000",
"cardAcceptorNameAddress": "MERCHANT NAME",
"account1Length": "19",
"zeroBalanceUrl": null,
"paymentFacilitatorId": "00000249333",
"amountCardholderBilling": "000000010000",
"submerchantId": "000007777777804",
"cardAcceptorStateOrCountryCode": "BRA",
"institutionId": null,
"posData": "00000000003",
"messageNumber": null,
"switchSerialNumber": "999999999",
"filler1": " ",
"independentSalesOrganizationId": " ",
"filler2": " ",
"recordType": "FPST"
}
],
"interchangeFee": "0000000014",
"switchSerialNumber": "999999999",
"filler1": " ",
"panLength": "16",
"filler2": " "
}
}
}
Mastercard fee collection event example
{
"event_id":"[valid-uuid]",
"org_id":"[tenant]",
"cid":"[valid-uuid-correlation-id]",
"domain":"authorization",
"event_type":"raw_credit_mastercard",
"schema_version": "1"
"timestamp":"2023-01-18T18:44:59Z",
"data" : {
"mti":"FEE_COLLECTION",
"processingCode":{
"transactionTypeCode":"19",
"codeFromAccountTypeCode":"00",
"codeToAccountTypeCode":"00"
},
"transactionAmount":1232,
"reconciliationAmount":"34324543",
"reconciliationConversionRate":"4324",
"functionCode":783,
"messageReasonCode":7804,
"forwardingInstitutionIdCode":"002202",
"additionalData":{
"p0015":"2301130",
"p0137":"19721830300000000",
"currencyExponents":"5553",
"businessActivity":"MMNN",
"p0159":"234342",
"settlementIndicator":"MMM****",
"originatingMessageFormat":"2",
"p1083":"X234"
},
"transactionCurrencyCode":"986",
"reconcilliationCurrencyCode":"986",
"messageNumber":"54535",
"dataRecord":"FEES ",
"dateAction":"230113",
"transactionDestinationInstitutionIdCode":null,
"transactionOriginatorInstitutionIdCode":"045532",
"receivingInstitutionIdCode":"065332",
"correlationId":"[cid]",
"orgId":"[tenant]",
"caller":"Mastercard",
"network":"Mastercard",
"authorizationCode":null,
"instituionId":"345644",
"endpoint":"004535",
"zeroBalanceUrl":null,
"clearingType":"CREDIT",
"category":null,
"origin":null,
"file_date":"2023-01-14",
"businessActivity":{
"businessServiceArrangementTypeCode":"2",
"corporateIncentiveRatesApplyIndicator":"N",
"businessServiceIdCode":"076000",
"masterPassIncentiveIndicator":"N",
"specialsConditionsIndicator":"N",
"interchangeRateDesignator":" ",
"rateIndicator":"N",
"accountLevelManagementAccountCategoryCode":"N",
"mastercardAssignedIdOverrideIndicator":"N",
"centralSiteBusinessDate":"230114",
"businessCycle":"04",
"cardAcceptorClassificationOverrideIndicator":" ",
"productClassOverrideIndicator":" ",
"cardProgramIdentifier":"MCC"
},
"settlementData":{
"settlementForeignExchangeRateClassCode":"N",
"settlementServiceTransferAgentIdCode":"23432 ",
"settlementServiceIdCode":"AV34242",
"settlementServiceLevelCode":"3",
"settlementDate":"230113",
"reconciliationCycle":"04",
"settlementCycle":"01",
"settlementServiceTransferAgentAccount":"2342342342",
"reconciliationDate":"230114"
},
"localTransactionDateTime":{
"date":"2023-01-18T04:16:25+0000",
"time":"1970-01-01T18:44:59+0000"
}
}
}
Visa EPIN example - clearing event
{
"event_id": "[valid-uuid]",
"domain": "networktransactions",
"event_type": "clearing",
"schema_version": "1",
"org_id": "[tenant]",
"cid": "[valid-uuid-correlation-id]",
"timestamp": "2022-12-08T03:00:00.813Z",
"data": {
"card_id": 99999,
"account_id": 88888,
"program_id": 123,
"file_type": "EPIN",
"network": "Visa",
"raw_message": {
"caller": "Visa",
"org": null,
"tcr02Data": {
"nationalReimbursementFee": "0000000000",
"reserved2": "",
"installmentPaymentCount": "00",
"specialMerchantIdentifier": "",
"reserved3": "",
"countryCode": "BR",
"transactionSequenceNumber": "2",
"specialPurchaseIdentifier": "",
"transactionQualifier": "0",
"centralProcessingDate": "0000",
"transactionCode": "05",
"settlementType": "027",
"reserved": ""
},
"correlationId": "[valid-uuid-correlation-id]",
"tcr03Data": null,
"origin": null,
"orgId": "[tenant]",
"tcr0EData": null,
"tcr05Data": {
"additionalDataIndicator": "",
"authorizationResponseCode": "00",
"excludedTransactionIdenfierReason": "",
"interchangeFeeSign": "C",
"authorizedAmount": "000000010000",
"transactionSequenceNumber": "5",
"dynamicCurrencyConversionIndicator": "",
"totalAuthorizedAmount": "000000000000",
"baseCurrencyToDestinationCurrencyExchangeRate": "00000000",
"multipleClearingSequenceNumber": "00",
"reserved1": "",
"informationIndicator": "N",
"accountTypeIdentification": "",
"chargebackRightsIndicator": "",
"merchantTelephoneNumber": "",
"multipleClearingSequenceCount": "00",
"authorizationCurrencyCode": "986",
"cvv2ResultCode": "",
"transactionIdentifier": "123450770799999",
"interchangeFeeAmount": "000000000199900",
"crsProcessingCode": "",
"productId": "N",
"programId": "",
"optionalIssuerISAAmount": "000000000000",
"sourceCurrencyToBaseCurrencyExchangeRate": "00000000",
"merchantVolumeIndicator": "",
"validationCode": "",
"merchantVerificationValue": "",
"panToken": "0000000000000000",
"transactionQualifier": "0",
"transactionCode": "05",
"marketSpecificAuthorizationDataIndicator": "",
"spendQualifiedIndicator": "",
"eletronicCommerceGoodsIndicator": ""
},
"transactionDestinationInstitutionIdCode": "[cardhash]",
"authorizationCode": "ABC123",
"type": "05",
"zeroBalanceUrl": null,
"fileDate": "2022-12-07",
"tcr07Data": {
"formFactorIndicator": "20700000",
"issuerApplicationDataByte3": "0A",
"cryptogramAmount": "000000010000",
"terminalVerificationResults": "0000000000",
"issuerApplicationDataByte8": "",
"terminalCapabilityProfile": "E0D8C8",
"applicationTransactionCounter": "027D",
"issuerApplicationDataByte17": "",
"issuerApplicationDataByte9to16": "",
"transactionSequenceNumber": "7",
"transactionType": "00",
"issuerApplicationDataByte18to32": "",
"issuerApplicationDataByte1": "06",
"terminalCountryCode": "076",
"applicationInterchangeProfile": "2000",
"issuerApplicationDataByte4to7": "03A06000",
"terminalTransactionDate": "221206",
"issuerApplicationDataByte2": "01",
"unpredictableNumber": "1234567F",
"issuerScript1Results": "",
"cryptogram": "ABC1239999977777",
"transactionQualifier": "0",
"transactionCode": "05",
"cardSequenceNumber": "000",
"terminalSerialNumber": ""
},
"tcr0DData": null,
"tcr04Data": {
"agentUniqueId": "",
"transactionSequenceNumber": "4",
"businessFormatCode": "SP",
"transactionQualifier": "0",
"dataContent": "0000 00000000 00000000V005555509999999994425077777770000000000",
"transactionCode": "05",
"reserved": ""
},
"tcr06Data": null,
"messageNumber": "999999",
"tcr01Data": {
"nationalReimbursementFee": "000000000000",
"reserved2": "",
"installmentPaymentCount": "01",
"specialChargebackIndicator": "",
"issuerCharge": "",
"acceptanceTerminalIndicator": "",
"reserved3": "0",
"specialConditionIndicators": "",
"prePaidCardIndicator": "",
"transactionSequenceNumber": "1",
"serviceDevelopmentField": "0",
"cashback": "000000000",
"reserved1": "",
"documentationIndicator": "",
"authorizationSourceCode": "V",
"purchaseIdentifier": "",
"posEnvironment": "",
"tokenAssuredLevel": "",
"mailPhoneEletronicIndicator": "",
"purchaseIndentifierFormat": "",
"accountSelection": "3",
"feeProgramIndicator": "",
"chargeBackReferenceNumber": "000000",
"chipConditionCode": "0",
"businessFormatCode": "",
"transactionQualifier": "0",
"memberMessageText": "0001007777700123499999",
"terminalId": "AN779999",
"transactionCode": "05",
"cardAcceptorId": "00116659999",
"additionalTokenResponse": "",
"avsResponseCode": "",
"conversionDate": "2341"
},
"tcr00Data": {
"collectionOnlyFlag": "",
"reimbursementAttribute": "A",
"merchantName": "MerchantName",
"usageCode": "1",
"accountNumber": "[card-hash]",
"destinationCurrencyCode": "986",
"accountNumberExtension": "000",
"acquirerBussinessId": "10074215",
"transactionSequenceNumber": "0",
"reserved1": "",
"sourceAmount": "000000010000",
"authorizationCode": "ABC123",
"authorizationCharacteristicsIndicator": "E",
"positiveCardholderAuthorizationServiceIndicator": "",
"merchantZipCode": "99999",
"settlementFlag": "8",
"cardholderIdMethod": "1",
"posTerminalCapabilities": "5",
"posEntryMode": "07",
"merchantCountryCode": "BR",
"merchantCity": "MERCHANTCITY",
"floorLimitIndicator": "B",
"requestedPaymentService": "A",
"destinationAmount": "000000010000",
"acquirerReferenceNumber": "29999952340777777763331",
"reasonCode": "00",
"transactionQualifier": "0",
"sourceCurrencyCode": "986",
"centralProcessingDate": "2341",
"transactionCode": "05",
"purchaseDate": "1206",
"merchantCategoryCode": "8999",
"exceptionFileIndicator": "",
"merchantStateProvinceCode": "",
"numberOfPaymentForms": ""
}
}
}
}
Tecban ServiceB example - clearing event
{
"event_id": "[valid-uuid]",
"domain": "networktransactions",
"event_type": "clearing",
"schema_version": "1",
"org_id": "[tenant]",
"cid": "[valid-uuid-correlation-id]",
"timestamp": "2022-12-09T12:07:56.082Z",
"data": {
"card_id": 999999,
"account_id": 888888,
"program_id": 123,
"file_type": "ServiceB",
"network": "Tecban",
"raw_message": {
"caller": "TECBAN",
"correlationId": "[valid-uuid-correlation-id]",
"occurrenceRecord": null,
"origin": null,
"serviceTrailer": null,
"headerFile": {
"maskedPasswordForTransmission": "",
"registryNsu": "00001",
"physicalMeansTransportingFile": "T",
"centralizingUnit": "01",
"filler": "",
"registrationCode": "A0",
"extensionIndicator": "N",
"financialInstituitionCode": "1208"
},
"orgId": "[tenant]",
"transactionDestinationInstitutionIdCode": "[",
"fileTrailer": null,
"headerServiceFile": {
"transmissionType": "1",
"processingType": "2",
"referenceData": "20221208",
"onlineTransactionFormat": null,
"currency": "RE",
"registryNsu": "00002",
"fileSequencialNumber": "0042",
"processingSequencialNumber": "1065",
"formatterOnlineTransactions": "2",
"filler": "",
"formatVersion": "03.6",
"registrationCode": "B0",
"extensionIndicator": "N"
},
"s3Path": null,
"mainTransactionRecord": {
"operationMode": "1",
"transactionNsu": "999999",
"transactionTime": "1713",
"transactionDate": "1208",
"operationUnitCode": "01",
"viaCard": "0",
"transactionAmount": "00000000002000",
"registrationCode": "B1",
"extensionIndicator": "S",
"releaseDate": "1208",
"numberOfInstallmentsForPaymentOfInstallments": "00",
"billingIndicator": "1",
"movementAccount": "[card-hash]",
"registryNsu": "99999",
"transactionStatus": "1",
"accountTypeMovementTransaction": "1",
"terminalId": "0061333",
"transactionCode": "000100"
},
"zeroBalanceUrl": null,
"messageNumber": "3643",
"supplementTransactionRecord": {
"transactionNsu": "999999",
"transactionTime": "1713",
"transactionDate": "1208",
"operationUnitCode": "01",
"backgroundCode": "0000000000",
"protectionPassword": "0",
"originCode": "0000",
"hostNsu": "000999999",
"registrationCode": "B2",
"extensionIndicator": "N",
"mainAccount": "[card-hash]",
"chipIndicator": "2",
"registryNsu": "03644",
"language": "0",
"terminalId": "0061574",
"filler1": "0000",
"filler2": "0"
},
"supplementOccurrenceRecord": null
}
}
}
Updated about 2 months ago