e-SiTef

e-SiTef

  • Portal do Desenvolvedor
  • Fale Conosco
  • English

›HTML Payment

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

Status notification

For each transaction status change, e-SiTef will notify the merchant about the changes according to the image below:

In the merchant's registration, the status URL must be informed. e-SiTef will send a POST containing the status of the transaction with the following parameters:

ParameterDescriptionFormat
nitNIT of the transaction= 64 A
pedidoOrder id (generated by the merchant).< 20 A
nsuSequential Number sent by the merchant.< 12 N
nsuSitefUnique Sequential Number (USN) of SiTef.< 10 A
nsuHostUnique Sequential number of the authorizer.< 20 A
nsuesitefe-SiTef's USN.= 15 A
statusOrder status. Learn more.= 3 A
cupomCustomer's receipt.< 4000 A
cupomEstabelecimentoMerchant's receipt.< 4000 A
autorizadoraAuthorizer code (on e-SiTef). Learn more.< 10 A
tipoPagamentoPayment type.

C=Credit
D=Debit
B=Boleto
= 1 A
dataSitefDate of the payment.

Format: DD/MM/YYYY hh:mm:SS

Attention: this parameter is only sent on confirmed transactions routed by SiTef.
= 19 A
dataEfetivacaoDate of the payment.

Format: DD/MM/YYYY hh:mm:SS

Attention: this parameter is only sent on confirmed transactions not routed by SiTef.
= 19 A
parcelasNumber of installments.< 2 N
tipoFinanciamentoFinancing type chosen by the customer.
3 = installments with interest
4 = installments without interest
= 1 N
mensagemAuthorizer message.< 1024 A
codigoRespostaAutorizadoraAuthorizer response code.< 1024 A
redeAuthorizer name, whereby the payment is being performed.< 500 A
numeroAutorizacaoAuthorization number (generated by the authorizer)= 6 A
tidTransaction ID received only on transactions not routed by SiTef, such as Cielo e-Commerce, e-Rede, e.Rede REST, etc.= 40 A
eciElectronic Commerce Indicator (ECI) of the transaction received only when performed through Verified By Visa or Secure Code Mastercard= 3 A
bandeiraIssuer code used in the transaction. P.S. this field is sent only at transactions via SiTef.< 5 N
analise.statusRisk analysis transaction status.
NOV = new
EXP = expired
ACC = accepted
REJ = rejected
REV = review
= 3 A
analise.codigoAntifraud institution's response code.< 3 N
analise.mensagemAntifraud institution's response message.< 30 A
NITTransacaoSecundariaSecondary transactions' NITs (separated by &#124; pipe) for split transactions.< 1040 A
binCartaoBIN (6 first digits) of the card used on the payment.= 6 N
finalCartaoLast 4 digits of the card used on the payment.= 4 N

In addition to the fields described above, if a recharge transaction is linked the following fields will be returned:

ParameterDescriptionFormat
recarga.nitTransaction NIT.= 64 A
recarga.nsusitefSiTef USN.< 10 A
recarga.nsuhostAuthorizer USN.< 20 A
recarga.nsuesitefe-SiTef USN.= 15 A
recarga.statusOrder status.= 3 A
recarga.cupomRecharge customer receipt.< 4000 A
recarga.cupomestabelecimentoRecharge merchant receipt.< 4000 A
recarga.codigoconcessionariaDealer code (on GwCel).< 10 A
recarga.redeAcquirer code.< 4 N
recarga.dataefetivacaoPayment date. Format: DD/MM/AAAA hh:mm:SS.

ATTENTION: : this parameter is only returned on confirmed transactions made by SiTef.
= 19 A
recarga.dataefetivacaositefPayment date. Format: DD/MM/AAAA hh:mm:SS.

ATTENTION: : this parameter is only returned on confirmed transactions not done by SiTef.
= 19 A
recarga.dadosconfirmacaoRecharge confirmation data. (alphanumeric sequence).= 12 A
recarga.telefonePhone number.< 20 N
recarga.dddPhone area code.< 4 N
recarga.valorRecharge amount.< 12 N
recarga.codigorespostahostDealer response code.< 4 N
recarga.codigorespostasitefSiTef response code.< 4 N
recarga.mensagemrespostahostDealer response message.< 64 A
recarga.mensagemrespostasitefSiTef response message.< 64 A

Important:

In addition to the above parameters, e-SiTef can return other ones without prior notice. Please, be prepared to receive extra parameters beyond the parameters in the table above that can be ignored.

It isn't necessary to return data on the POST, however if the POST is not successful (HTTP Status-Code 200: OK), e-SiTef will try again until the configured number of times on the system, before giving up and leaving the transaction as pending notification, as seen on the images below.

e-SiTef's POST/HTTPS may not be immediate, as it will be asynchronous. The delay may vary according to the server load and the internet. If a problem occurs on sending, e-SiTef will try to resend the message after a certain time range, up to 3 times.

Not all of the parameters will be present on all transactions. Some parameters might not be sent depending on the payment method or if the transaction is not concluded, for example.

Attempts of status change notifications:

Failed attempts of status change notifications:

← Initializing a payment transactionTransaction status query →
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