SaFi Bank Space : SaFi-Euronet Card Transaction API Guide v1.7

_{Unreconciled Report}

_{contains exception transactions which need to be settled or reversed}

_{the report shall contain “originalDataElement” and “originalTransactionID” for transactions to be reverse to customer}

_{Refund Report}

_{contains transactions to release the blocked amount}

_{the report shall contain “originalDataElement” and “originalTransactionID” for transactions to be reverse to customer}

_{Amount Difference Report}

_{contains transactions which settlement amount is to be adjusted}

_Name

_{Data Type}

_Max

_WDL

_ECOM

_POS

_{Money Send}

_Description

_mti

_string

₄

_M

_M

_M

_M

_{Message Type Identifier}

_proxyNumber

_string

₂₀

_M

_M

_M

_M

_{unique identifier for a card}

_{processingCode}

_string

₆

_M

_M

_M

_M

_{Refer to processing codes section}

_{transactionAmount}

_int

₂₀

_M

_M

_M

_M

_{Transaction amount is the value dispensed / entered at transaction origination. The decimal value is decided from the Currency code. ISO 4217. This denotes the original currency or acquirer currency, need not be PHD(home currency).}

_{When Reversal:}

_{In case transaction is in local currency only this field will be present. So Original debit posting to be reversed or say this amount to be reversed.}

_{cardHolderBillingAmount}

_int

₂₀

_M

_M

_M

_M

_{Cardholder amount is transaction amounted converted to local currency amount, (PHD)}

_{When Reversal:}

_{In case transaction is international transaction this field will be present along with above field (absent in case of domestic transaction). So Original debit posting to be reversed or say this amount to be reversed.}

_{replacementAmount}

_int

₂₀

_O

_O

_O

_O

_{When Partial-Reversal:}

_{This field needs to be checked in reversal transaction. If present this is partial reversal domestic transaction. This original transaction needs to be reversed and amount present in this field needs to be debited.}

_{cardHolderReplacementAmount}

_int

₂₀

_O

_O

_O

_O

_{When Partial-Reversal:}

_{This field needs to be checked in reversal transaction. If present this is partial reversal international transaction. This original transaction needs to be reversed and amount present in this field needs to be debited.}

_{transmissionDateTime}

_string

₃₆

_M

_M

_M

_M

_{Transmission Date and Time to be sent in ISO 8601 format, eg: 2022-01-25T04:01:52Z, in SGT format}

_{systemTraceAuditNumber}

_string

₆

_M

_M

_M

_M

_{Number to trace in euronet system}

_{localTransactionDateTime}

_string

₃₆

_M

_M

_M

_M

_{Local Transaction Date and Time at the acquirer side to be sent in MMDDhhmmss.
(Time zone is not known) ISO 8601 format, eg: 2022-01-25T04:01:52Z}

_{merchantCategoryCode}

_string

₄

_M

_M

_M

_M

_{Merchant Category Code}

_{acquirerCountryCode}

_string

₃

_C

_C

_C

_C

_{Acquirer bank country code to be passed in numeric code in ISO 4217. This field will tell where the txn is performed. Currently not used in MC platform}

_panEntryMode

_string

₃

_M

_M

_M

_M

_{PAN entry mode, see complete list below}

_networkID

_string

₃

_M

_M

_M

_M

_{“MCN” Mastercard Network}

_PosDataSF4

_string

₁

_M

_M

_M

_M

_{POS Cardholder Presence indicates whether the cardholder is
present at the point of service and explains the condition if the cardholder is not
present.}

_PosDataSF5

_string

₁

_M

_M

_M

_M

_{POS Card Presence indicates if the card is present at the point
of service.}

_PosDataSF7

_string

₁

_M

_M

_M

_M

_{POS Transaction Status indicates the purpose or status of the request.}

_PosDataSF10

_string

₁

_M

_M

_M

_M

_{Cardholder-Activated Terminal Level indicates the type of cardholder activated terminal used by the cardholder to initiate the transaction}

_acquirerID

_string

₁₁

_M

_M

_M

_M

_{Unique id for Acquirer bank}

_{retrievalReferenceNumber}

_string

₁₂

_M

_M

_M

_M

_{Retrieval reference number can be used to trace the transaction from acquirer, scheme and euronet. Generated by acquirer, unique for that particular txn. Can be duplicated across different acquirers.}

_{authorizationID}

_string

₆

_M

_M

_M

_M

_{Authorization ID, to be generated by EN and sent this request.}

_{cardAcceptorTerminalID}

_string

₁₆

_M

_C

_M

_M

_{Merchant Terminal ID/ ATM ID}

_{cardAcceptorMerchantID}

_string

₁₆

_M

_M

_M

_M

_{Merchant ID/ For ATM what will this be?}

_{cardAcceptorTermName}

_string

₄₀

_M

_M

_M

_M

_{Merchant name and description/ ATM Name and location.
Refers to DE43 in MC specs.
Use last three characters of this field to identify DCC.
If PH or PHL then local,
if not PH or PHL, then can be fx or dcc.
If transactionCurrencyCode is 608, then DCC. else fx.}

_{transactionCurrencyCode}

_string

₃

_M

_M

_M

_M

_{Transaction currency represents the currency in which transaction was performed. Format: ISO 4217, for example USD, need not be home currency.}

_{cardHolderCurrencyCode}

_string

₃

_M

_M

_M

_M

_{Cardholder currency represents the currency of issuer ISO 4217, home currency}

_{transactionID}

_string

₁₅

_M

_M

_M

_M

_{Unique ID for all transaction requests across MC EN and AIG,}

_{OrgtransactionID}

_string

₁₅

_O

_C

_C

_O

_{This field will be used in follow up transactions like incremental auth, reversals and advice of the original transactions.}

_{threeDsAuthTID}

_string

₃₆

_O

_C

_O

_O

_{The Directory Server Transaction ID is generated by the EMV 3DS Mastercard
Directory Server during the authentication transaction. Transaction ID during authorization in order to link authentication and authorization data.}

_{DCCIndicator*}

_string

₁

_C

_C

_C

_O

_{Only populated for DCC Txn}

_{ECOMindicator}

_string

₂

_O

_C

_O

_O

_{Ecommerce Indicator.
This field will represent if its Ecommerce Transaction or Tokenized Payment transaction.}

_{UCAFIndicator}

_string

₁

_O

_C

_O

_O

_{UCAF Collection Values represeting security of Ecommerce Transaction}

_{threeDsValidation}

_string

₁

_O

_C

_O

_O

_{This will be populated when Switch validates IAV successfully}

_{PANValidation}

_string

₁

_M

_M

_M

_M

_{PANValidation.}

^{P – Performed ;N – Not-performed}

_{expiryDateValidation}

_string

₁

_M

_M

_M

_M

_{Expiry date validation,}

^{P – Performed ;N – Not-performed}

_{pinValidation}

_string

₁

_M

_O

_C

_O

_{Pin validation check. Only present if transaction is PIN base transaction. Like For ATM txns.}

^{P – Performed ;N – Not-performed}

_{CVVValidation}

_string

₁

_M

_O

_M

_O

_{CVV Validation. Only present if transaction is Card base transaction. CVV is present in the physical card mag data.}

^{P – Performed ;N – Not-performed}

_{CVV2Validation}

_string

₁

_O

_C

_O

_O

_{CVV2 Validation. Only present if transaction is Non-Card base transaction}

^{P – Performed ;N – Not-performed}

_{EMVValidation}

_string

₁

_M

_O

_M

_O

_{EMV Validation. Only present if transaction is EMV Card base transaction}

^{P – Performed ;N – Not-performed}

_{MSTransactionTypeId}

_String

₃

_O

_O

_O

_C

_{Transaction Type Identifier used to identify type / mode of funding}

_{Valid Values
C07 = MoneySend Person-to-Person
C52 = MoneySend Account-to-Account Transfers
C53 = MoneySend Agent Cash Out
C54 = MoneySend Credit Card Bill Payment
C55 = MoneySend Business Disbursement
C56 = MoneySend Government/Nonprofit Disbursement
C57 = MoneySend Acquirer Merchant Settlement
C58 = MoneySend Cash2ATM
C59 = MoneySend Cash2Card
C65 = MoneySend Business to Business Transfer}

_{MSTransactionRefData}

_String

₃₅₈

_O

_O

_O

_C

_{Additional transaction reference Data containing Sender Data}

_{Will be forwarded as received from MC.}

_RRN

_String

_M

_M

_M

_M

_cardVendor

_String

_M

_M

_M

_M

• _MASTERCARD

• _BANCNET

• _SAFI

_feeAmount

_int

_O

_O

_O

_O

_feeCurrency

_String

_C

_C

_C

_C

_{transactionCode}

_String

_M

_M

_M

_M

• _{DOMESTIC_PAYMENT}

• _{INTERNATIONAL_PAYMENT}

• _{DOMESTIC_VOID_PAYMENT}

• _{INTERNATIONAL_VOID_PAYMENT}

• _{SAFI_ATM_WITHDRAWAL}

• _{EXTERNAL_ATM_WITHDRAWAL}

• _{INTERNATIONAL_ATM_WITHDRAWAL}

• _{SAFI_ATM_TRANSFER}

• _{EXTERNAL_ATM_TRANSFER}

• _{INTERNATIONAL_BALANCE_INQUIRY}

• _{EXTERNAL_BALANCE_INQUIRY}

_categoryCode

_String

_M

_M

_M

_M

• _ATM

• _POS

• _ECOMM

00

PAN entry mode unknown

01

PAN manual entry

02

PAN auto-entry via magnetic stripe—track data is not required.

OR

The acquirer is not qualified to submit magnetic stripe transactions, so Mastercard replaced value 90 or 91 with value 02.

03

PAN auto-entry via bar code reader

04

PAN auto-entry via optical character reader (OCR)

05

PAN auto-entry via chip

07

PAN auto-entry via contactless M/Chip

09

PAN/Token entry via electronic commerce containing DSRP cryptogram in DE 55 (Integrated Circuit Card [ICC] System-Related Data).

10

Credential on File

79

A hybrid terminal with an online connection to the acquirer failed in sending a chip fallback transaction (in which DE 22, subfield 1 = 80) to the issuer.

or

A hybrid terminal with no online connection to the acquirer failed to read the chip card. The merchant is prompted to read the magnetic stripe from the card, the magstripe is successfully read and indicates a service code 2XX (or 6XX if card is domestic).

To complete the transaction in both cases, a voice transaction takes place during which the merchant communicates the PAN and the expiry date originating from the magstripe track 2 data to the acquirer. The acquirer then sends an online transaction to the issuer in which the value of DE 22, subfield 1 = 79 and in which DE 61 subfield 11 indicate that the terminal is chip capable.

Refer to the M/Chip Requirements for additional information.

80

Chip card at chip-capable terminal was unable to process transaction using data on the chip; therefore, the terminal defaulted to the magnetic stripe-read PAN.

The full track data has been read from the data encoded on the card and transmitted within the Authorization Request/0100 in DE 45 (Track 1 Data) or DE 35 (Track 2 Data) without alteration or truncation.

To use this value, the acquirer must be qualified to use value 90.

81

PAN/Token entry via electronic commerce with optional Identity Check-AAV or DSRP cryptogram in UCAF.

82

PAN Auto Entry via Server (issuer, acquirer, or third party vendor system).

90

PAN auto-entry via magnetic stripe—the full track data has been read from the data encoded on the card and transmitted within the authorization request in DE 35 (Track 2 Data) or DE 45 (Track 1 Data) without alteration or truncation.

91

PAN auto-entry via contactless magnetic stripe—the full track data has been transmitted by the acquirer within the authorization request in DE 35 (Track 2 Data) or DE 45 (Track 1 Data) and forwarded to the issuer without alteration or truncation.

95

Visa only. Chip card with unreliable Card Verification Value (CVV) data.

₀₀

₂₀₀

Success

transaction successful

₀₁

_{InvalidRequestException}

₄₀₀

_{request is not valid. please check the request}

_{request validation error}

₀₂

_{InvalidAccountException}

₄₀₀

_{account not found or not valid}

_{account not found}

₀₃

_{AccountBlockedException}

₄₀₀

_{transaction cannot proceed because the account is ${accountStatus}}

_{account status either FREEZE/BLOCKED}

₀₄

_{InsufficientBalanceException}

₄₀₀

_{not enough balance}

_{balance not enough}

₀₅

_{CardNotFoundException}

₄₀₀

_{card with proxy number ${proxyNumber} is not found}

_{not found card}

₀₆

_{CardBlockedException}

₄₀₀

_{card with proxy number ${proxyNumber} is ${cardStatus}}

_{card status either LOCKED/PERMANENT_BLOCKED}

₀₇

_{CardLimitExceededException}

₄₀₀

_{transaction amount is exceed the limit}

_{card transaction limit exceeded}

₀₈

_{TransactionNotPermittedException}

₄₀₀

_{transaction is not permitted by card holder}

_{the incoming transaction is not permitted by card holder. eg. international transaction}

₀₉

_{FraudRejectionException}

₄₀₀

_{rejected by fraud system}

_{rejected by fraud system}

₁₀

_{PostingTimeoutException}

₄₀₈

_{time out, please try again}

_{timeout during posting}

₁₁

_{UnhandledException}

₅₀₀

_{unhandled error}

_{unhandled error}