e-SiTef

e-SiTef

  • Portal do Desenvolvedor
  • Fale Conosco
  • English

›Anti-Fraud Integration

REST Payment

  • Overview
  • Quick start
  • Transaction creation service
  • Payment effectuation service
  • Payment confirmation service
  • Transaction status query
  • Multiple transactions status query
  • Card query service
  • Payment with multiple payment methods service
  • Payment with multiple payment methods confirmation service
  • External origin payment confirmation service

REST Store

  • Overview

REST Cancel

  • Flow
  • Quick start
  • Cancel via host
  • Cancel external origin
  • Cancel creation service
  • Cancel service

REST Pre-Authorization

  • Overview
  • Quick start
  • Pre-Authorization Creation Service
  • Pre-Authorization effectuation service
  • Pre-Authorization Status Query
  • Pre-Authorization Editing Service
  • Pre-Authorization Editing External Origin Service
  • Pre-Authorization Increment Service
  • Card Query Service
  • Pre-Authorization Capture Service
  • Pre-Authorization Capture External Origin Service

REST Schedule

  • Overview
  • Quick start
  • Transaction creation service
  • Schedule activation service
  • Execution of the scheduled payments
  • Schedule editing flow
  • Quick start: schedule editing
  • Schedule editing creation service
  • Schedule editing service

REST Recharge

  • Overview
  • Quick start
  • Recharge creation service
  • List dealers service
  • List branch data service
  • Recharge effectuation service
  • Recharge confirmation service
  • Recharge query service

HTML Payment

  • Overview
  • Quick start
  • Initializing a payment transaction
  • Status notification
  • Transaction status query
  • Payment with card storage
  • Pages Customization
  • Payment link
  • Split Payment
  • Payment with multiple payment methods
  • 3DS 2.0 Integration

HTML Pre-Authorization

  • Overview

HTML Recharge

  • Overview
  • Quick start
  • Initializing a Recharge transaction

REST Generic Operations

  • Overview
  • Token creation service
  • Generic operation service

JavaScript Payment

  • Overview
  • Quick start
  • Transaction creation service
  • Virtual store's payment page
  • Transaction query service

JavaScript Store

  • Overview
  • Quick start
  • Transaction creation service
  • Virtual store's page

Merchant Web Page

  • Introduction
  • Access to web page
  • Two-Factor Authentication
  • User Configuration
  • Configure Authorizers
  • Transaction Report
  • Daily Summary Report
  • Store Report
  • Recharge Report
  • Analytical Report
  • Transaction Cancellation
  • Schedule
  • Configure Risk Analysis
  • Configure Order Authorizers
  • Users Administration
  • Generate Payment Link

Retry

  • Overview
  • Flow
  • Retry and Schedule

SiTef Routings

  • Bradescard
  • Cetelem
  • GetnetLac
  • Orbitall
  • Vero
  • Bin
  • Sipag

Non SiTef Routings

  • Banco do Brasil
  • Banrisul Vero
  • Cielo e-Commerce
  • EPX
  • e.Rede Rest
  • Fepas HUB
  • Getnet WS
  • GlobalPayments WS
  • IPG
  • Itaú Shopline
  • Mercado Pago
  • PagSeguro
  • PayPal
  • SafraPay
  • Stone WS

Digital Wallet

  • Overview
  • VEE Digital Wallet via CardSE
  • Pix via CardSE
  • Google Pay
  • Visa Checkout
  • Masterpass
  • Samsung Pay
  • Apple Pay
  • Configuration for Digital Wallets

Anti-Fraud Integration

  • Overview
  • Risk analysis service on the HTML Interface
  • Risk analysis response
  • Manual review flow
  • Fraud notification service
  • ClearSale
  • CyberSource
  • Konduto
  • Fraud Detect

General Information

  • Authorizers
  • Digital Certificates
  • API codes
  • Soft Descriptor
  • Signature authentication

Batch Registrations

  • Batch Store Registration
  • Batch Routing Configuration

REST Merchants Registration

  • Overview
  • Quick start
  • Token creation service
  • Merchant creation service
  • Merchant editing service
  • Merchant query service
  • Merchant status query service
  • List merchants service
  • API codes

3DS Server

  • Overview
  • Quick start
  • Transaction creation service
  • Authentication service
  • Transaction query service
  • Challenge messages
  • Decoupled notification
  • Initiating a 3DS Method
  • API codes

Konduto

Required credentials

As mentioned in the "Overview - Required credentials" chapter, each institution has credentials that must be obtained for the integration. Konduto's services demand the credentials below:

  • Private Key (Merchant Identification) - Private key of the merchant on Konduto.
  • Public Key (Merchant Code) - Public key of the merchant on Konduto.

IMPORTANT: The credentials above should be obtained from Konduto. It is recommended to contact Konduto and receive guidance on how to obtain the credentials. Then, the merchant should contact e-SiTef support and send the credentials to register on e-SiTef.

Web Hook URL Configuration

In order for us to receive status updates from the risk analysis transactions, it is necessary to configure the Webhook URL on the Konduto configuration environment.

Production URL:

https://esitef-ec.softwareexpress.com.br/e-sitef/processarPost.se?src=konduto

Homologation URL:

https://esitef-homologacao.softwareexpress.com.br/e-sitef/processarPost.se?src=konduto

This URL must be configured for any status changes. To perform this configuration, please contact Konduto Support.

Allowed card brands

Konduto supports any card brand.

IMPORTANT: Only credit transactions will be effectively analyzed by Konduto. Debit transactions will be sent to the institution, but will only be stored for reporting and will not be analyzed.

Supported e-SiTef interfaces

  • Payment Link via Portal
  • HTML Payment Link via HTML
  • REST Payment
  • REST Pre-Authorization

Konduto's anti-fraud parameters (Payment Link via HTML)

For now, the data collected for the risk analysis will only be informed during the payer's checkout. Soon, new fields may be sent in the payment creation request.

Fields collected during Checkout

The fields collected during checkout are:

FieldField DescriptionRequired
Primeiro Nome do CompradorFirst name of the payer.Yes
Sobrenome do CompradorFirst name of the payer.Yes
CPF do CompradorCPF of the payer.Yes
TelefonePhone number of the payer.Yes
E-mailEmail of the payer.Yes
Nome (como está no cartão)Name that is printed on the card used for the purchase.Yes
Endereco completoFull billing address.Yes
ComplementoComplement of the billing address.No
CEPZip code of the billing address.Yes
PaísCountry of the billing address.Yes
EstadoState of the billing address.Yes
CidadeCity of the billing address.Yes

Example

Example of the HTML payment request with risk analysis at Konduto:

{
   "merchant_id":"KONDUTOTEST",
   "merchant_usn":"803208495",
   "order_id":"866705726000010",
   "redirect":"A",
   "style":"N",
   "amount":"100000",
   "authenticate":"0",
   "transaction_type":"payment",
   "payment_link":"true",
   "additional_data":{
      "currency":"BRL",
      "anti_fraud":"enabled_after_auth"
   }
}

Konduto's Anti-Fraud in the Payment Link via Portal

To enable Konduto's anti-fraud for Payment Links generated by the Merchant Portal, please contact e-SiTef's support team.

Konduto Antifraud via REST

After finishing your registration on e-SiTef, enabling the antifraud service integration, when initializing a REST payment (learn more) or REST pre-authorization (learn more), the merchant must send the anti_fraud property and the antifraud parameters (depending on the institution you're using), both included in the additional_data object.

The anti_fraud field determines how the risk analysis will be applied and may contain the following values:

  • enabled_before_auth - The antifraud will be executed BEFORE the payment authorization. If the analysis is rejected, the payment won't be initiated. In the case of a pre-authorization with a non-SiTef routing, if the antifraud requires a manual analysis, the e-SiTef leaves the transaction in the PPC (Pending Confirmation Payment) state and awaits the completion of the manual evaluation.
  • enabled_after_auth - The antifraud will be executed AFTER the payment authorization. If the analysis is rejected, the payment that was already authorized will be cancelled. In the case of a pre-authorization with a non-SiTef routing, the e-SiTef leaves the transaction in the PPC (Pending Confirmation Payment) state and awaits the completion of the manual evaluation.

Konduto antifraud parameters

Below are described the antifraud parameters supported by Konduto.

ParameterDescriptionMandatoryFormat
additional_data Additional transaction data
visitor_idVisitor identifier obtained using Konduto's JavaScriptNO< 40 AN
additional_data
.items[]
Shopping cart information
unit_priceItem unit price in centsNO< 10 N
skuItem product codeNO< 100 AN
quantityItem quantityNO< 10 N
idUnique item identification, that may be its bar code or UPC.NO< 100 AN
titleProduct or service nameNO< 100 AN
discount_amountDiscount amount of the product in centsNO< 10 N
descriptionProduct descriptionNO< 100 AN
creation_dateIndicates the date of publication of the product on the merchant's site (Format: DD/MM/YYYY)NO= 10 AN
additional_data
.payer
Customer information
idUnique customer identifier. It may be any value (sequential, document, e-mail), as long as it's consistent on future orders.YES< 100 AN
nameCustomer nameYES< 100 AN
surnameCustomer surnameYES< 100 AN
emailCustomer e-mailYES< 100 AN
born_dateCustomer birth date (format : YYYY-MM-DDTHH:MM:SS)NO= 19 AN
identification_numberCustomer document numberNO< 100 AN
creation_dateAccount creation date on the site (format: DD/MM/YYYY )NO= 10 AN
is_new_clientBoolean that indicates if the customer is using a recently created account in this purchaseNO< 5 T/F
is_vip_clientBoolean that indicates if the customer is VIP or a frequent buyerNO< 5 T/F
additional_data
.payer
.phones[]
Customer phone information
ddiCustomer phone IDDNO< 100 AN
dddCustomer phone DDDNO< 100 AN
numberCustomer phone numberNO< 100 AN
additional_data
.billing_data
.address
Billing address information
street_nameBilling street nameNO< 255 AN
street_numberBilling street numberNO< 255 AN
complementBilling address complementNO< 100 AN
cityBilling cityNO< 100 AN
stateBilling stateNO< 100 AN
zip_codeBilling zip codeNO< 100 A N
countryBilling country code, following ISO 3166-1 alfa-3NO= 3 AN
additional_data
.shipment
Shipment information
nameName of the recipientNO< 100 AN
surnameSurname of the recipientNO< 100 AN
additional_data
.shipment
.address
Shipment address information
street_nameDelivery street nameNO< 255 AN
street_numberDelivery street numberNO< 255 AN
complementDelivery address complementNO< 255 AN
cityDelivery cityNO< 100 AN
stateDelivery stateNO< 100 AN
zip_codeDelivery zip codeNO< 100 AN
countryDelivery country code, following ISO 3166-1 alfa-3NO= 3 AN
additional_data
.travel
Travel information
transport_typeTravel transport type (flight or bus)YES< 6 AN
expiration_dateExpiration date (format: DD/MM/YYYY )NO= 10 AN
additional_data
.connections[]
Travel connections information
journey_type
  • OUTWARD - outward journey
  • RETURN - return trip
YES< 7 AN
origin_cityOrigin cityYES, if transport_type=bus< 100 AN
destination_cityDestination cityYES, se transport_type=bus< 100 AN
fromIATA airport code of the origin airportYES, if transport_type=flight= 3 AN
toIATA airport code of the destination airportYES, if transport_type=flight= 3 AN
departure_dateDeparture date and time (format: YYYY-MM-DDTHH:MM:SS)YES< 17 AN
classSeat class name (Ex: economy, business or first)NO< 8 AN
class_codeSeat class codeNO< 20 AN
companyAirline nameNO< 20 AN
additional_data
.passengers[]
Passengers information
namePassenger first nameYES< 100 AN
last_namePassenger last nameYES< 100 AN
legal_documentPassenger documentYES< 100 AN
legal_document_typePassenger document type (5 = passport, any other number = id)YES< 8 AN
birth_datePassenger birth date (format: YYYY-MM-DDTHH:MM:SS)NO< 17 AN
nationalityPassenger nationality, following ISO 3166-1 alfa-3NO= 3 AN
is_frequent_travelerFrequent traveler booleanNO< 5 T/F
is_with_special_needsBoolean which indicates if it's a passenger with special needsNO< 5 T/F
frequent_flyer_cardLoyalty program typeNO< 255 AN
customer_classLoyalty program categoryNO< 255 AN
additional_data
.hotel_reservations[]
Hotel reservation information
hotelHotel nameYES< 100 AN
categoryHotel categoryNO< 100 AN
additional_data
.hotel_reservations[]
.address
Hotel address information
street_nameHotel street nameNO< 255 AN
street_numberHotel street numberNO< 255 AN
complementHotel address complementNO< 100 AN
cityHotel cityNO< 100 AN
stateHotel stateNO< 100 AN
zip_codeHotel zip codeNO< 100 AN
countryHotel country code, following ISO 3166-1 alfa-3NO= 3 AN
additional_data
.hotel_reservations[]
.rooms[]
Hotel rooms information
numberRoom numberNO< 100 AN
codeRoom codeNO< 100 AN
typeRoom typeNO< 100 AN
check_in_dateCheck-in date and time (format: YYYY-MM-DDTHH:MM:SS)YES< 17 AN
check_out_dateCheck-out date and time (format: YYYY-MM-DDTHH:MM:SS)NO< 17 AN
number_of_guestsNumber of guestsNO< 9999 N
board_basisFeeding regimeNO< 100 AN
additional_data
.hotel_reservations[]
.rooms[]
.guests[]
Hotel room guests information
nameGuest nameYES< 100 AN
documentGuest documentNO< 8 AN
document_typeGuest document type:
  • cpf
  • rg
  • passport
  • id
  • other
NO< 8 AN
birth_dateGuest birth date (format: YYYY-MM-DDTHH:MM:SS)NO< 17 AN
nationalityGuest nationality, following ISO 3166-1 alfa-3NO= 3 AN
additional_data
.events[]
Event information
nameEvent nameYES< 255 AN
dateEvent date and time (format YYYY-MM-DDTHH:MM:SS)YES< 17 AN
typeEvent type:
  • show
  • theater
  • movies
  • party
  • festival
  • course
  • sports
  • corporate
YES< 9 AN
subtypeEvent type detailsNO< 255 AN
additional_data
.events[]
.venue
Event venue information
nameVenue nameNO< 255 AN
street_nameVenue street nameNO< 255 AN
street_numberVenue street numberNO< 255 AN
cityVenue cityNO< 255 AN
stateVenue stateNO< 255 AN
countryVenue country code, following ISO 3166-1 alfa-3NO= 3 AN
capacityVenue capacityNO< 255 AN
additional_data
.events[]
.tickets[]
Event tickets information
idUnique ticket identifierNO< 255 AN
categoryTicket category:
  • student
  • senior
  • government
  • social
  • regular
YES< 10 AN
sectionTicket sectionNO< 255 AN
premiumPremium ticket indicatorNO< 5 T/F
additional_data
.events[]
.tickets[]
.atendee
Event atendee information
nameAtendee nameNO< 255 AN
documentAtendee documentYES< 100 AN
document_typeAtendee document type:
  • cpf
  • cnpj
  • rg
  • passport
  • other
NO< 100 AN
birth_dateAtendee birth date (format: YYYY-MM-DDTHH:MM:SS)NO< 17 AN

Example

Below is an example of a REST payment creation request with Konduto risk analysis:

{
   "merchant_usn":"2423423434",
   "order_id":"2432342343",
   "installments":"1",
   "installment_type":"4",
   "authorizer_id":"2",
   "amount":"1300",
   "additional_data":{
      "anti_fraud":"enabled_before_auth",
      "visitor_id":"XKhas09jcks",
      "items":[
         {
            "title":"title1",
            "quantity":"1",
            "unit_price":"1111",
            "description":"description1",
            "id":"id1",
            "discount_amount":"111",
            "sku":"sku1",
            "creation_date":"11/01/2011"
         }
      ],
      "payer":{
         "name":"Marcos",
         "surname":"da Silva",
         "email":"marocs@dasilva.com",
         "born_date":"1990-01-01T11:11:11",
         "creation_date":"02/03/2004",
         "is_new_client":"true",
         "is_vip_client":"true",
         "phones":[
            {
               "number":"333333333",
               "ddd":"22",
               "ddi":"11"
            },
            {
               "number":"666666666",
               "ddd":"55",
               "ddi":"44"
            }
         ],
         "identification_number":"47764543004"
      },
      "shipment":{
         "name":"Fernando",
         "surname":"Bezerra",
         "address":{
            "zip_code":"98764312",
            "street_number":"987",
            "street_name":"Rua Shipment",
            "complement":"ap. 587",
            "city":"São Shipment",
            "state":"MA",
            "country":"BRA"
         }
      },
      "passengers":[
         {
            "name":"Miguel",
            "last_name":"Herrera",
            "frequent_flyer_card":"frequentFlyerCard",
            "legal_document_type":"1",
            "legal_document":"12312312312",
            "birth_date":"1980-07-28T10:40:00",
            "customer_class":"customerClass",
            "nationality":"BRA",
            "is_frequent_traveler":"true",
            "is_with_special_needs":"true"
         }
      ],
      "connections":[
         {
            "company":"Verde",
            "class":"first",
            "from":"GRU",
            "to":"CGH",
            "departure_date":"2023-09-07T07:09:00",
            "journey_type":"OUTWARD",
            "origin_city":"San Juan",
            "destination_city":"Homero Lopez",
            "class_code":"VIP"
         },
         {
            "company":"Rosa",
            "class":"economy",
            "from":"BSB",
            "to":"VCP",
            "departure_date":"2022-10-21T16:39:00",
            "journey_type":"RETURN",
            "origin_city":"San Pablo",
            "destination_city":"Juanito Cruz",
            "class_code":"ECONOMY"
         }
      ],
      "hotel_reservations":[
         {
            "hotel":"Hotel Green Tree",
            "address":{
               "zip_code":"83392019",
               "street_number":"529",
               "street_name":"Rua Hoteleira",
               "complement":"ap. 019",
               "city":"San Hotel",
               "state":"AC",
               "country":"EN"
            },
            "rooms":[
               {
                  "number":"902",
                  "code":"ROOM902",
                  "type":"King Size",
                  "check_in_date":"2020-01-09T12:30:00",
                  "check_out_date":"2020-01-19T13:00:00",
                  "number_of_guests":"1",
                  "board_basis":"Vegan",
                  "guests":[
                     {
                        "name":"José Aníbal",
                        "document":"98798798712",
                        "document_type":"cpf",
                        "birth_date":"12/03/1970",
                        "nationality":"BRA"
                     }
                  ]
               }
            ],
            "category":"categoryhotel"
         }
      ],
      "billing_data":{
         "address":{
            "zip_code":"12341234",
            "street_number":"666",
            "street_name":"Rua Billing",
            "complement":"ap. 2369",
            "city":"São Billing",
            "state":"AM",
            "country":"BRA"
         }
      },
      "travel":{
         "transport_type":"flight",
         "expiration_date":"2022-02-14T01:30:00"
      },
      "discount_info":"Informações de desconto",
      "events":[
         {
            "name":"Evento de Rock",
            "date":"2021-11-22T09:28:00",
            "type":"show",
            "subtype":"music",
            "venue":{
               "name":"Debicard Hall",
               "street_name":"Rua do Evento",
               "street_number":"928",
               "city":"Jardinópolis",
               "state":"MS",
               "country":"DO",
               "capacity":"300"
            },
            "tickets":[
               {
                  "id":"12h374612h4h",
                  "category":"social",
                  "section":"Seção 1",
                  "premium":"true",
                  "attendee":{
                     "name":"Daniel Almeida",
                     "document":"71728293945",
                     "document_type":"other",
                     "birth_date":"03/10/1990"
                  }
               }
            ]
         }
      ]
   }
}
← CyberSourceFraud Detect →
  • Required credentials
  • Web Hook URL Configuration
  • Allowed card brands
  • Supported e-SiTef interfaces
  • Konduto's anti-fraud parameters (Payment Link via HTML)
  • Fields collected during Checkout
  • Example
  • Konduto's Anti-Fraud in the Payment Link via Portal
  • Konduto Antifraud via REST
  • Konduto antifraud parameters
  • Example
e-SiTef
Relacionamento com o cliente
+55 (11) 3170-5300+55 (11) 4766-8000comercial@softwareexpress.com.br
Acessos
Portal do DesenvolvedorPortal e-SiTefVersão para impressão
Copyright © 2021 Software Express Informática Ltda - Todos os direitos reservados