e-SiTef

e-SiTef

  • Portal do Desenvolvedor
  • Fale Conosco
  • English

›REST Schedule

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

Execution of the scheduled payments

Daily, e-SiTef will process the scheduled payments of the current day and will update the data of the executed schedules, like the current number of executions. If the schedule was already executed by the number of times defined by the merchant, it will have its status changed to FIN (finished) and will be disregarded in future processing procedures, as only schedules with ATV (active) status will be executed.

The current number of executions will only be incremented for payments that were confirmed or denied. In the case of denied transactions, e-SiTef won't reprocess them.

For each payment done, e-SiTef will send a POST to the merchant status URL configured on e-SiTef, informing many data of the recurrent payment.

Status notification of the recurrent payments

On the merchant registration, a Status URL must be informed, where e-SiTef will send a HTTPS POST (x-www-form-urlencoded) containing the status of the transaction in addition to the following parameters:

curl -X POST \
  https://dominiocadastrado.com.br \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -H 'Postman-Token: b639d289-f3c9-4cec-a0e3-a4e3742a792e' \
  -H 'cache-control: no-cache' \
  -d 'rede=Cielo&tipoFinanciamento=4&binCartao=455182&nsuesitef=191107123456780&tid=authorizerTransactionId12345678901234567&parcelas=2&nsu=merchantNsu&autorizadora=1&nit=nitWith64charsLike1234567890123456789012345678901234567890123457&pedido=orderId1234&
  tipoPagamento=C&finalCartao=2345&status=NEG'
ParameterDescriptionFormat
nitIdentifier of the transaction.= 64 A
pedidoOrder code.< 20 A
nsuUnique sequential number sent by the merchant.< 12 N
nsuSitefUnique sequential number returned by SiTef.< 10 A
nsuHostUnique sequential number returned by the authorizer.< 20 A
nsuesitefUnique sequential number generated by e-SiTef.= 15 A
statusStatus of the transaction, as described in the table in item 24.1.= 3 A
cupomCustomer's receipt. It doesn't contain line breaks, as each line is separated by @ instead.< 4000 A
cupomEstabelecimentoMerchant's receipt. It doesn't contain line breaks, as each line is separated by @ instead.< 4000 A
autorizadoraCode of the authorizer on e-SITef.< 10 A
tipoPagamentoPayment type: C=Credit, D=Debit, B=Boleto= 1 A
dataSitefPayment authorization date returned by the acquirer in DD/MM/YYYY hh:mm:ss format.= 19 A
dataEfetivacaoPayment authorization date on e-SiTef in DD/MM/YYYY hh:mm:ss format.= 19 A
parcelasNumber of installments.< 2 N
tipoFinanciamentoFinancing type selected by the customer.= 1 N
mensagemAuthorizer message.< 1024 A
redeAcquirer name.< 500 A
numeroAutorizacaoAuthorization number.= 6 A
tidTransaction ID. This field will only be sent on payments with acquirers that are external to SiTef.= 40 A
eciElectronic Commerce Indicator (ECI) of the transaction. Currently, this field can only be returned by transactions with Cielo e-Commerce.= 3 A
bandeiraIssuer code.< 5 N
binCartaoBIN (first 6 digits) of the card used on the payment.= 6 N
finalCartaoLast 4 digits of the card used on the payment.= 4 N

Important:

Besides the parameters above, e-SiTef can return others without previous warning. Please, be prepared to receive extra parameters besides those in the table above, which 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.

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.

Schedule restrictions

Listed below are functionalities that are unsupported by the schedule operation:

  • Sending SiTef prefixes
  • Payments with authentication
  • Payments with fraud analysis
  • IATA transactions
  • Using cards with SiTef's encryption
  • Sending the card security code on the scheduled payments
← Schedule activation serviceSchedule editing flow →
  • Status notification of the recurrent payments
  • Schedule restrictions
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