Fepas HUB
The merchant can configure Online Payment transactions to be routed by several payment providers. One of them is FEPAS HUB.
The objective of this document is to describe the required configurations on Online Payment to enable transactions to be routed by FEPAS HUB.
ATTENTION: This routing is only for contactless transport transactions.
#
Online Payment Interfaces Supported for IntegrationYou can use the following interfaces for integration with Fepas HUB routing:
- REST Payment
- REST Cancel
- REST Pre Authorization
- REST Logon
- REST Table Load
ATTENTION:The schedule feature is not supported by this integration.
#
REST PaymentThe following fields are complementary to the existing fields mentioned in the documentation Payment effectuation service.
#
REST Payment Effectuation#
Payment RequestParameter | Description | Format | Required |
---|---|---|---|
resubmission_id | ID for resubmitting a previously denied payment in certain cases as allowed by the issuer. | = 16 N | Cond. |
acquirer_id | Routing code to be used on the transaction. It can assume the values listed in the Routing Codes table. If this field is not sent, the authorizer configuration will be used to define the routing. | < 4 N | NO |
original_authorization_number | Original transaction authorization number. | <6 AN | Cond. |
authorizer_mac | MAC of the purchase transaction (all brands) 4 positions ASCII Merchant Advice Code (MAC). | < 4 AN | Cond. |
authorization_terminal | Attribute of type authorization_terminal | ||
authentication | Attribute of type authentication | ||
terminal | Attribute of type terminal | ||
card | Attribute of type card | ||
mtt | Attribute of type mtt |
#
Payment Request ExampleTo use this example, don't forget to define the variable {{url}}
with the value
esitef-homologacao.softwareexpress.com.br
#
Payment ResponseParameter | Description | Format |
---|---|---|
resubmission_id | ID used for resubmitting in case of denied payment. | = 16 N |
payment | Attribute of type payment | |
card | Attribute of type resp_card |
#
Payment Response Example#
REST Payment ConfirmationThe following fields are complementary to the existing fields mentioned in the documentation Payment confirmation service.
#
Confirmation RequestParameter | Description | Format | Required |
---|---|---|---|
issuer_scripts_results | Issuer Scripts Results Mandatory if the transaction uses an EMV chip. | = N/A AN | Cond. |
#
Confirmation Request ExampleTo use this example, don't forget to define the variable {{url}}
with the value
esitef-homologacao.softwareexpress.com.br
#
Confirmation ResponseNo additional parameters are required.
#
Confirmation Response Example#
REST Cancellation#
REST Cancel EffectuationThe following fields are complementary to the existing fields mentioned in the documentation Cancel service.
#
Cancel RequestParameter | Description | Format | Required |
---|---|---|---|
terminal | Attribute of type terminal | ||
card | Attribute of type card | ||
authentication | Attribute of type authentication |
#
Cancel Request ExampleTo use this example, don't forget to define the variable {{url}}
with the value
esitef-homologacao.softwareexpress.com.br
#
Cancel ResponseParameter | Description | Format | Required |
---|---|---|---|
cancellation Attribute of type cancellation |
#
Cancel Response Example#
REST Pre-AuthorizationThe following fields are complementary to the existing fields mentioned in the documentation Pre-Authorization effectuation service.
#
REST Pre-Authorization Effectuation#
Pre-Authorization RequestParameter | Description | Format | Required |
---|---|---|---|
resubmission_id | ID for resubmitting a previously denied payment in certain cases as allowed by the issuer. | = 16 N | Cond. |
acquirer_id | Routing code to be used on the transaction. It can assume the values listed in the Routing Codes table. If this field is not sent, the authorizer configuration will be used to define the routing. | < 4 N | NO |
authentication | Attribute of type authentication | ||
terminal | Attribute of type terminal | ||
card | Attribute of type card | ||
mtt | Attribute of type mtt |
#
Pre-Authorization Request ExampleTo use this example, don't forget to define the variable {{url}}
with the value
esitef-homologacao.softwareexpress.com.br
#
Pre-Authorization ResponseParameter | Description | Formato |
---|---|---|
resubmission_id | ID used for resubmitting in case of denied payment. | = 16 N |
pre_authorization | Attribute of type pre_authorization | |
card | Attribute of type resp_card |
#
Pre-Authorization Response Example#
REST Pre-Authorization CaptureThe following fields are complementary to the existing fields mentioned in the documentation Pre-Authorization Capture Service.
#
Pre-Authorization Capture Request ExampleTo use this example, don't forget to define the variable {{url}}
with the value
esitef-homologacao.softwareexpress.com.br
#
Pre-Authorization Captura ResponseNo additional parameters are required.
#
Pre-Authorization Captura Response Example#
Logon RESTThe logon is a new and an exclusive feature of the Online Payment FEPAS routing.
If the request version
field is different from the response acquirer_table_load
.version
field, it is necessary to do a table load.
#
Logon RequestParameter | Description | Format | Required |
---|---|---|---|
authorizer_id | Authorizer code. | < 4 N | YES |
acquirer_id | Routing code to be used on the transaction. It can assume the values listed in the Routing codes table. | < 4 N | NO |
version | It is the version of the parameters table related to an Authorizer. Each Authorizer may have a distinct version of those parameters. Attention: If the Merchant does not have any table to the informed Authorizer, this field must contain only zeroes. | < 8 N | YES |
terminal | Attribute of type terminal NOTE: Just the id attribute is required in the terminal attribute during the Logon. |
#
Logon Request ExampleTo use this example, don't forget to define the variable {{url}}
with the value
esitef-homologacao.softwareexpress.com.br
#
Logon ResponseParameter | Description | Format |
---|---|---|
code | Online Payment response code. Any code different from ‘0’ represents a failure. To find more information, check the API Codes section. | < 4 N |
message | Online Payment response message. | < 500 AN |
acquirer_table Attribute of type acquirer_table |
#
Logon Response Example#
REST Table LoadThe table load is a new and an exclusive feature of the Online Payment FEPAS routing. This request can be made successfully only after a logon and will reuse the information returned by it (for instance, acquirer_table_load
.usn
, authorizer_id
, version
and terminal
.id
).
#
Table Load RequestParameter | Description | Format | Required |
---|---|---|---|
authorizer_id | Authorizer code. It must have the same value as the one informed at the logon request. | < 4 N | YES |
acquirer_id | Routing code to be used on the transaction. It can assume the values listed in the Routing Codes table. If this field is not sent, the authorizer configuration will be used to define the routing. | < 4 N | NO |
version | It is the version of the parameters table related to an Authorizer. Each Authorizer may have a distinct version of those parameters. It must have the same value as the one informed at the Logon request. NOTE: If the Merchant does not have any table to the informed Authorizer, this field must contain only zeroes. | < 4 N | YES |
terminal | Attribute of type terminal NOTE: Just the id attribute is required in the terminal attribute during the Tables load. |
#
Table Load Request ExampleTo use this example, don't forget to define the variable {{url}}
with the value
esitef-homologacao.softwareexpress.com.br
#
Table Load ResponseParameter | Description | Format |
---|---|---|
code | Online Payment response code. Any code different from ‘0’ represents a failure. To find more information, check the API Codes section. | < 4 N |
message | Online Payment response message. | < 500 AN |
acquirer_table | Attribute of type acquirer_table |
#
Table Load Response Example#
Data Typesauthorization_terminal
#
Parameter | Description | Format | Required |
---|---|---|---|
usn | NSU of the Authorization Terminal of the original transaction | = 6 N | Cond. |
local_date_time | Local date and time of the original transaction ('MMddHHmmss' format) | = 10 N | Cond. |
authentication
#
Parameter | Description | Format | Required |
---|---|---|---|
pin Attribute of type authentication.pin |
authentication
.pin
#
Parameter | Description | Format | Required |
---|---|---|---|
value | Encrypted PIN. Mandatory when the cardholder types the password online. | < 16 AN | Cond. |
crypto | Attribute of type pin.crypto |
pin
.crypto
#
Parameter | Description | Format | Required |
---|---|---|---|
type | PIN encryption process. It can assume the values listed in the PIN Encryption Process Codes table. This field is mandatory only when the PIN is sent. | = 3 N | Cond. |
ksn | PIN encryption KSN. Mandatory when the cardholder types the password online. | < 20 AN | Cond. |
terminal
#
Parameter | Description | Format | Required |
---|---|---|---|
id | Terminal ID. | < 8 AN | SIM |
type | Terminal Attendance Type. It can assume the values listed in the Terminal Attendance Type Codes table. | = 1 N | SIM |
input_mode | Terminal input capability. It can assume the values listed in the Terminal Input Capability Codes table. | = 2 N | SIM |
pin_pad_physical_features | PIN-pad physical features. It can assume the values listed in the PIN-pad Physical Feature Codes table. | = 1 N | SIM |
handling_type | Password handling type. It can assume the values listed in the Password Handling Type Codes table. | = 1 N | SIM |
reader_capabilities | Reader capabilities. It can assume the values listed in the Card Reader Capability Codes table. | = 1 N | SIM |
chip_conditions | CHIP conditions. It can assume the values listed in the CHIP Condition Codes table. | = 1 N | SIM |
card
#
Parameter | Description | Format | Required |
---|---|---|---|
service_code | This field has 3 digits and those three digits appear after the track 2 expiry date, according to the ISO/IEC 7813 standards. Track 2 example: ;1234567890123445=99011200XXXX00000000?* Service Code: 120. | = 3 N | Cond. |
bin | The card BIN field must be sent when the transaction is typed or made by either track or chip. This field has 6 digits and those 6 digits appear after the track 2 starting sentinel, according to the ISO/IEC 7813 standards. Track 2 example: ;1234567890123445=99011200XXXX00000000?* Card BIN: 123456. | = 6 N | Cond. |
last4 | Credit card last four digits must be sent when the transaction is typed or made by either track or chip. Those four digits appear before the track 2 separator (“=”), according to the ISO/IEC 7813 standards. Track 2 example: ;1234567890123445=99011200XXXX00000000?* Last four digits: 3445. | = 6 N | Cond. |
track_1 | Track 1, encrypted according to the rules established between the Merchant and Software Express. This field is mandatory if the Track 1 is sent. | AN N/A | Cond. |
track_2 | Credit card Track 2 or client identification. The Track 2 is encrypted by hardware according to the rules established between the Merchant and Software Express. This field is mandatory if the Track 2 is sent. | < 99 | Cond. |
subtype | Credit card subtype. It can assume the values listed in the Subtype Codes table. Mandatory if the transaction is made with a voucher. | = 2 AN | Cond. |
crypto | Attribute of type card.crypto | ||
pin | Attribute of type card.pin | ||
pos_entry_mode | Attribute of type pos_entry_mode | ||
emv | Attribute of type emv | ||
number | Card number (PAN). Used in the service(s): Cancel | LLvar n..99 N | Cond. |
expiry_date | Card expiry date. Used in the service(s): Cancel | = 4 N | Cond. |
security_code | Card security code. Used in the service(s): Cancel | = 6 N | Cond. |
card
.crypto
#
Parameter | Description | Format | Required |
---|---|---|---|
ksn | KSN (Key Serial Number) of the PAN encryption and track 2 (field card.track_2). Used in DUKPT cryptography. Mandatory when PAN/track 2 encryption type DUKPT (004) is used. If absent the PAN encryption type 3DES (002) is assumed. | = 20 AN | COND |
ksn_trac_1 | KSN (Key Serial Number) of the track 1 encryption (filed card.track_1). Used in DUKPT cryptography. Mandatory when track 1 encryption type DUKPT (004) is used. If absent the PAN encryption type 3DES (002) is assumed. | = 20 AN | COND |
card
.pin
#
Parameter | Description | Format | Required |
---|---|---|---|
value | Encrypted PIN. Mandatory when the cardholder types the password online. | < 64 | Cond. |
resp_card
#
Parameter | Description | Format |
---|---|---|
token | Carat Online Payment stored card HASH. It is forbidden to send an AN open card number (‘number’ field) and a stored card (‘token’ field) in the same request. | = 88 AN |
par | PAR (Payment Account Reference). | = 29 AN |
pos_entry_mode
#
Parameter | Description | Format | Required |
---|---|---|---|
value | Card input mode. It can assume the values listed in the Card Input Mode Codes table. | = 2 N | YES |
pin_capability | Terminal PIN input capabilities. It can assume the values listed in the Terminal PIN Input Capability Codes table. | = 1 N | YES |
emv
#
Parameter | Description | Format | Required |
---|---|---|---|
card_sequence_number | Card sequence number of the EMV card used (tag 5F34 ).This field is mandatory only when the transaction uses an EMV chip and the card informs this data.. | < 3 N | Cond. |
data | This field holds the EMV tags of transactions using an EMV chip. Its contents are sent in ASCII bytes, in the following TLV format: type, length, content. For example, if we were to send: Tag: 82 - (Application Interchange Profile), length: 2, content: 5800; Tag: 9F27 - (Cryptogram Information Data), length: 1, content: 80; Tag: 9F26 - (Application Cryptogram), length: 8, content b42433f98916b331. The resulting value would be: "data":"820258009F2701809F2608B42433F98916B331". This field is mandatory if the transaction uses an EMV chip. | < 999 N/A | Cond. |
mtt
#
Parameter | Description | Format | Required |
---|---|---|---|
id | MTT transaction ID (Mass Transport Transaction). Informs the type of the requested transaction. It can assume the values listed in the MTT transaction ID Codes table. | = 1 N | Cond. |
first_journey_date | MTT transaction first journey date, following the MMDD format. | = 4 N | Cond. |
vehicle_id | Vehicle identification. Mandatory for MTT | = 18 N | NO |
gps_location | GPS Location, must be sent in MTT transactions with the vehicle location in decimal latitude and longitude, for example: 050.167958;-097.133000 (xxx.nnnnnn;-xxx.nnnnnn), where is: “xxx” – Degree matches; “.” – Degree and Minutes Separator; “nnnnnn” – Minutes converted to fraction of degrees; “;” – Latitude and Longitude separator; “-“ – Indication of negative degrees. | < 24 AN | NO |
transport_mode_indicator | Transport mode indicator. Required for MTT. Transport Mode Indicator table | < = 2 N | NO |
payment
#
Parameter | Description | Format |
---|---|---|
acquirer_table_load_required | This field shows whether an Authorizer table load must be done or not. 0 - Parameters are up-to-date. 1 - The parameters are outdated – the Merchant must do a Table Load. | = 1 N |
conciliation_authorizer_merchant_id | Sale establishment code. | = 15 |
authorization_terminal | Attribute of type authorization_terminal |
pre_authorization
#
Parameter | Description | Format |
---|---|---|
acquirer_table_load_required | This field shows whether an Authorizer table load must be done or not. 0 - Parameters are up-to-date. 1 - The parameters are outdated – the Merchant must do a Table Load. | = 1 N |
conciliation_authorizer_merchant_id | Sale establishment code. | = 15 |
authorization_terminal | Attribute of type authorization_terminal |
cancellation
#
Parameter | Description | Format |
---|---|---|
acquirer_table_load_required | Informs if the Merchant need to do a table load along with an Authorizer. 0 - Parameters are up-to-date. 1 - ‘1’ – Parameters are outdated – the Merchant must do a Table Load. | = 1 N |
conciliation_authorizer_merchant_id | Código de Estabelecimento da Venda. | = 15 N |
authorization_terminal | Attribute of type authorization_terminal |
authorization_terminal
#
Parameter | Description | Format |
---|---|---|
usn | Authorization terminal USN. | = 6 N |
id | Authorization terminal ID. | = 8 AN |
acquirer_table
#
Parameter | Description | Format |
---|---|---|
code | FEPAS operation response code. | = 2 AN |
message | FEPAS response message. | < 999 AN |
usn | Operation USN. | = 6 N |
date | Local date and time. | = 19 N |
authorizer_id | Authorizer code. | < 4 N |
merchant_code | Merchant code. | < 15 AN |
version | It is the version of the parameters table related to an Authorizer. Each Authorizer may have a distinct version of those parameters. Attention: If the Merchant does not have any table to the informed Authorizer, this field must contain only zeroes. | < 8 N |
signature | Parametrization signature. | < 999 AN |
acquirer_id | Acquirer code. Returns in the service(s): Table Load | < 4 N |
acquirer_name | Acquirer name. Returns in the service(s): Table Load | N/A AN |
credit_bins[] | Attribute of type product_bins Returns in the service(s): Table Load | |
debit_bins[] | Attribute of type product_bins Returns in the service(s): Table Load | |
emv_params[] | Attribute of type emv_params Returns in the service(s): Table Load | |
public_keys[] | Attribute of type public_keys Returns in the service(s): Table Load | |
mandatory_emv_tags[] | Attribute of type mandatory_emv_tags Returns in the service(s): Table Load | |
optional_emv_tags[] | Attribute of type optional_emv_tags Returns in the service(s): Table Load | |
emv_tags[] | Attribute of type emv_tags Returns in the service(s): Table Load | |
brand_per_credit_aid[] | Attribute of type brand_per_x_aid Returns in the service(s): Table Load | |
brand_per_debit_aid[] | Attribute of type brand_per_x_aid Returns in the service(s): Table Load |
product_bins
#
Parameter | Description | Format |
---|---|---|
brand_code | Card brand code. It can assume the values listed in the Brand Codes table. | = 2 AN |
is_voucher | Identifies if the card is a voucher. Allowed values: S - Yes N - No | = 1 AN |
features | Bits map composed by 1 binary byte (2 ASCII hexadecimal characters) that indicates the transaction input features. The 8 th position is the most significant bit and each bit represents a different feature. If a bit is equals 1 , the feature is present; if it is 0 , the feature is absent.Bit order: 87654321. The list of bits can be found in the Features Map. | = 2 AN |
subtype | Card subtype. It can assume the values listed in the SubType Codes table. | = 2 AN |
bin | Attribute of type bin |
bin
#
Parameter | Description | Format |
---|---|---|
start | Range starting BIN. | = 9 N |
end | Range ending BIN. This field has the same individual BIN validation as the previous field. | = 9 N |
emv_params
#
Parameter | Description | Format |
---|---|---|
aid_code | AID code. | = 2 N |
aid_length | AID length in bytes (from 05 to 16 ). | = 2 N |
aid | AID – Application Identifier. | = 32 H |
application_type | Application type. Allowed values: 01 - Credit02 - Debit | = 2 N |
application_name | Application default tag. | = 61 AN |
default_value | Application default value. 03 - EMV. | = 2 N |
version_opt_1 | Application Version Number (Terminal) – option #1 . | = 4 h |
version_opt_2 | Application Version Number (Terminal) – option #2 . | = 4 h |
version_opt_3 | Application Version Number (Terminal) – option #3 . | = 4 h |
terminal_country_code | Terminal Country Code. | = 3 N |
transaction_currency_code | Transaction Currency Code. | = 3 N |
transaction_currency_exponent | Transaction Currency Exponent. | = 1 N |
merchant_id | Merchant Identifier. | = 15 AN |
merchant_category_code | Merchant Category Code. | = 4 N |
terminal_id | Terminal Identification. | = 8 AN |
terminal_capabilities | Terminal Capabilities. It is the bits map that indicates the terminal capabilities. The format and values can be found in the Terminal Capabilities Map. | = 6 H |
terminal_capabilities_additional | Additional Terminal Capabilities. | = 10 H |
terminal_type | Terminal Type. It can assume the values listed in the Terminal Type Codes table. | = 2 N |
terminal_action_code_default | Terminal Action Code - Default . | = 10 H |
terminal_action_code_denial | Terminal Action Code – Denial . | = 10 H |
terminal_action_code_online | Terminal Action Code – Online . | = 10 H |
terminal_floor_limit | Terminal Floor Limit. | = 8 H |
transaction_category_code | Transaction Category Code. | = 1 AN |
tdol | Transaction Category Code. Default Transaction Certificate Data Object List (TDOL) (filled with bytes “00” to the right). | = 40 H |
ddol | Default Dynamics Data Authentication Data Object List (DDOL) (filled with bytes “00” to the right). | = 40 H |
authorization _response_code _offline_approved | Authorization Response Code - offline approved. | = 2 AN |
authorization _response_code _offline_declined | Authorization Response Code - offline declined. | = 2 AN |
authorization _response_code _unable_online_offline_approved | Authorization Response Code - unable to go online - offline approved. | = 2 AN |
authorization _response_code _unable_online_offline_declined | Authorization Response Code - unable to go online - offline declined. | = 2 AN |
contactless_zero_amount | Informs if the contactless chip supports zero amount transactions. Allowed values: 0 - Does not support. 1 - Supports, but only if the transaction is online. | = 1 N |
contactless_mode | Terminal AID handling capabilities if the card chip is contactless. It can assume the values listed in the Terminal AID Handling Capabilities Codes table. | = 1 N |
contactless_transaction_limit | Terminal/Reader Contactless Transaction Limit. | = 8 H |
contactless_floor_limit | Terminal/Reader Contactless Floor Limit. | = 8 H |
contactless_cvm_limit | Terminal/Reader CVM Required Limit. | = 8 H |
contactless_application_version | PayPass Mag Stripe Application Version Number (Terminal). | = 4 H |
contactless_selection_mode | Informs the application selection mode to contactless cards. Allowed values: 0 - The application is selected automatically according to a priority list. 1 -A selection menu will be presented if there is any other compatible application. | = 1 N |
contactless _terminal_action _code_default | Terminal Action Code – Default (for contactless cards). | = 10 H |
contactless _terminal_action _code_denied | Terminal Action Code – Denied (for contactless cards). | = 10 H |
contactless _terminal_action _code_online | Terminal Action Code – Online (for contactless cards). | = 10 H |
public_keys
#
Parameter | Description | Format |
---|---|---|
rid | RID - Registered Application Provider Identifier. | = 10 H |
certification_authority _public_key_index | Certification Authority Public Key Index. | = 2 H |
certification_authority _public_key_exponent_size | Certification Authority Public Key Exponent (1 ou 3 ) length in bytes. | = 1 N |
certification_authority _public_key_exponent | Certification Authority Public Key Exponent (left aligned). | = 6 H |
certification_authority _public_key_modulus_size | Certification Authority Public Key Modulus (until 248 )length in bytes. | = 3 N |
certification_authority _public_key_modulus | Certification Authority Public Key Modulus (left aligned). | = 496 H |
checksum_status | Status do Check Sum (Hash SHA-1). Allowed values: 0 - Not used.1 - Present. | = 1 N |
certification_authority _public_key_checksum | Certification Authority Public Key Check Sum (Hash SHA-1). | = 40 h |
mandatory_emv_tags
#
Parameter | Description | Format |
---|---|---|
aid_code | AID code. | = 2 N |
mandatory_emv_tags | Mandatory EMV tags list. Those tags must be sent in the request messages or in the advice transactions EMV data of a complete EMV flow, both online and offline, after the First Generate AC. Example: 9F269F27959F10 . | N/A AN |
optional_emv_tags
#
Parameter | Description | Format |
---|---|---|
aid_code | AID code. | = 2 N |
optional_emv_tags | Optional EMV tags list. Those tags can be sent in the request messages or in the advice transactions EMV data of a complete EMV flow, both online and offline, after the First Generate AC. | N/A AN |
emv_tags
#
Parameter | Description | Format |
---|---|---|
aid_code | AID code. | = 2 N |
all_emv_tags | Bit 55 EMV tags list. Those tags must be sent in the Bit 55 of confirmation messages or in the advice transactions EMV data of a complete EMV flow, both online and offline, after the Second Generate AC. Example: 9F269F27959F10 . | N/A AN |
brand_per_x_aid
#
Parameter | Description | Format |
---|---|---|
aid_code | AID code. | = 2 N |
brand_code | Brand code. | = 3 N |
#
Tables & Maps#
Routing CodesCódigo | Description |
---|---|
2005 | Rede |
2013 | GoodCard |
2047 | Sorocred |
2052 | Tricard |
2054 | Up Brasil |
2072 | Bigcard |
2077 | Valecard |
2094 | Cabal |
2125 | Cielo |
2201 | VR |
2206 | Global Payments |
2265 | Stone |
2309 | Adiq |
5001 | Alelo |
#
Brand CodesCódigo | Description |
---|---|
001 | Visa |
002 | Mastercard |
003 | Amex |
005 | Hipercard |
006 | Diners |
008 | JCB |
012 | Sorocred |
014 | Policard |
016 | Elo |
017 | Cabal |
043 | Tricard |
054 | Valecard |
058 | VR |
065 | Alelo |
158 | Bigcard |
235 | Up |
999 | Unknown brand |
#
Features MapPassword collection rule with trail in the Purchase:
- Checks if the service code is turned on (bit 8);
- If it is, then it uses the service code to determine password collection; or
- Otherwise, it uses bit 7 to determine password collection.
Password collection rule with trail in the Cancellation:
- Checks if the service code is turned on (bit 8);
- If it is, then it uses the service code to determine password collection; or
- Otherwise, it uses bit 6 to determine password collection.
#
Table for Byte 1Bit | Description |
---|---|
8 | It allows you to type data. |
7 | Requests the last 4 digits (track). |
6 | Magnetic fallback allowed. |
5 | Enables Typed Fallback. |
4 | Reserved for future use. |
3 | Magnetic transaction requires security code (CVV2/CVC2). |
2 | Request security code (typed). |
1 | Allows non-existent or unreadable CVV. |
#
Table for Byte 2Bit | Description |
---|---|
8 | Uses service code to determine if it asks for a password (track). |
7 | Requests password (track). |
6 | Requests password on cancellation (track). |
5 | Requests password (entered). |
4 | Request ID (DNI para Argentina). |
3 | Request plan code. |
2 | Requests type of account (checking or savings). |
1 | Validates card expiration date. |
#
Table for Byte 3Bit | Description |
---|---|
8 | Requests security code for magnetic invoice payment (track). |
7 | Requests security code for magnetic invoice payment (track). |
6 | Allows non-existent or illegible security code for invoice payment. |
5 | Process chip on cancellation. |
4 | Processes chip on invoice payment. |
3 | Reserved for future use. |
2 | Reserved for future use. |
1 | Reserved for future use. |
#
Subtype CodesCódigo | Description (filled with 00 when card is not debit/voucher) |
---|---|
00 | Card is not of type Debit/Voucher. |
01 | Debit/Food Voucher. |
02 | Debit/Meal Voucher. |
03 | Debit/Culture Voucher. |
04 | Debit/Fuel Voucher |
05 | Debit/Voucher Benefit |
19 | Debit/Voucher Other (Undefined) |
25 | Debit/PEI (Inmediate Electronic Payments) |
#
Terminal Capabilities MapFormat:
ABCxxxxx DEFGKxxx HIJMxxxx
Position | Description |
---|---|
A | Card number typed. |
B | Magnetic card. |
C | Contact chip card. |
D | Open PIN chip card verification. |
E | Encrypted PIN online verification. |
F | Signature on paper. |
G | Encrypted PIN chip card verification. |
K | “No CVM” (without bearer verification) method is allowed. |
H | SDA – Static Data Authentication – of card with chip. |
I | DDA - Dynamic Data Authentication – of card with chip. |
J | Card capture. |
M | Offline authentication CDA. |
#
Terminal Type CodesCode | Description |
---|---|
21 | Online. |
22 | Off-line with online capability. |
23 | Only off-line. |
24 | Online, unattended. |
25 | Off-line with online capability, unattended. |
26 | Only off-line, unattended. |
#
Terminal AID Handling Capabilities CodesCode | Description |
---|---|
0 | No support. |
1 | Supports VISA MSD. |
2 | Supports VISA qVSDC. |
3 | Supports MasterCard PayPass Mag Stripe. |
4 | Supports MasterCard PayPass M/Chip. |
5 | Supports Amex Expresspay Magstripe Mode. |
6 | Supports Amex Expresspay EMV Mode. |
#
PIN Encryption Process CodesCode | Description |
---|---|
001 | 3DES between the Merchant and the Authorizer (bypass Software Express). |
002 | 3DES between the Merchant and Software Express. Software Express will do the translation for the Authorizer. |
003 | DUKPT 3DES between the Merchant and the Authorizer (bypass Software Express). |
004 | DUKPT 3DES between Merchant and Software Express. Software Express will do the translation for the Authorizer. |
#
Terminal Attendance Type CodesCode | Description |
---|---|
0 | Terminal with cashier. |
2 | ATM. |
#
Terminal PIN Input Capability CodesCode | Description |
---|---|
0 | Undefined. |
2 | No terminal (IVR/Voice). |
5 | Chip reader. |
#
PIN-pad Physical Feature CodesPosition 1 Code | Description |
---|---|
1 | No PIN-pad |
3 | PIN-pad with chip reader. |
6 | PIN-pad with contactless and chip reader. |
Position 2 Code | Descrição |
---|---|
0 | PIN-pad without magnetic reader. |
1 | PIN-pad with magnetic reader. |
#
Password Handling Type CodesCode | Description |
---|---|
1 | No password. |
2 | Online password. |
3 | Off-line password. |
#
Card Reader Capability CodesCode | Description |
---|---|
4 | Chip and magnetic stripe reader enabled. |
5 | Contactless and magnetic stripe reader enabled. |
6 | Contactless and chip reader enabled |
7 | Contactless, magnetic stripe and chip reader enabled. PIN- pad with chip reader. |
#
Chip Condition CodesCode | Description |
---|---|
1 | Track without fallback. |
2 | Track with fallback. |
#
Card Input Mode CodesCode | Description |
---|---|
01 | Card number manual input (typed). |
02 | Magnetic stripe. |
05 | Chip. |
07 | Contactless chip. |
81 | Magnetic stripe fallback (used when the chip reading fails and the first position of the track service code is equals to 2 or 6, indicating that the transaction was made using a card chip). |
89 | E-commerce. |
91 | Contactless magnetic stripe. |
#
Terminal PIN Input Capabilities CodesCode | Description |
---|---|
0 | Not applicable. |
1 | PIN input capability is present. |
2 | PIN input capability is absent. |
#
MTT transaction ID CodesCode | Description |
---|---|
1 | AVR (transaction must come with amount zero). |
2 | MTT credit transaction. |
3 | Debt Recovery (resubmission, necessary sending resubmission_id field) |
4 | E-commerce/MOTO Debt Recovery (for typed transactions). |
5 | Tap Online Debt Recovery (for contactless transactions). |
6 | KFT (Known Fare Transaction – or Known Amount Transaction). This model accepts Credit or Debit transactions. |
7 | Debt Recovery tap online to KFT. |
8 | ATC update (zero value transaction). |
#
Pin Entry Capability CodesCode | Description |
---|---|
0 | Not applicable |
1 | Has PIN entry capability |
2 | No PIN entry capability |
#
Transport Mode Indicator TableCode | Description |
---|---|
00 | Unknown |
01 | City Bus |
02 | Long-distance Bus |
03 | Subway |
04 | Collective Train |
05 | Train |
06 | Waterborne vehicle |
07 | Toll |
08 | Parking |
09 | Taxi |
10 | high speed train |
11 | rural bus |
12 | Express train |
13 | Transit vehicle |
14 | Self-drive vehicle |
15 | Training vehicle |
16 | Locomotive |
17 | Motor vehicle |
18 | Trailer |
19 | Regional train |
20 | Transport between city |
21 | Funicular train |
22 | Tram, cableway |