e-SiTef

e-SiTef

  • Portal do Desenvolvedor
  • Fale Conosco
  • English

›REST Recharge

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

REST Recharge

Overview

The data collection will be conducted by the store, which will capture top up and card data (in case of top up with payment) or only top up data (if it's desired to perform only a top up).

Communication

To make a Web Service transaction, the whole communication must be done via HTTPS/TLS. It's important that the merchant's server supports encryption of a minimum of 128 bits. The merchant's server must make calls on specific addresses to do REST transactions.

Each service must be called using the base URL concatenated with the desired resource (see the chapter related to the service to be consumed). The HTTP method (GET, POST or PUT) indicates the expected action on the selected resource. Listed below are the base URLs of e-SiTef:

Production base URL:

https://esitef-ec.softwareexpress.com.br/e-sitef

Homologation base URL:

https://esitef-homologacao.softwareexpress.com.br/e-sitef

Every call received by the services will be responded synchronously.

Attention:

Never use the IP instead of the esitef-ec.softwareexpress.com.br domain. The IP can change at any time without previous warning, so it's important to use the domain when accessing e-SiTef.

Important:

Besides the response parameters of the services described in this specification, e-SiTef can return other parameters without previous warning.

It's important that the application is prepared to receive the unknown parameters besides the fields already specified and simply ignore them.

Recharge flow without payment

The recharge flow without payment can be performed as shown in the figure above.

The developer must follow what was specified in the e-SiTef integration document and send the parameters:

  • According to the size and type (numeric or alphanumeric);
  • Whether the field is mandatory, conditional or optional.

Briefly, below is the transactional flow for Recharge. With this, some doubts should be clarified, streamlining the integration process with e-SiTef.

  • 1. The flow starts with the application of the store making a call to create the recharge transaction;
    • 1.1. Synchronously, e-SiTef will do a HTTPS POST on the authenticity URL informed by the merchant and registered on the e-SiTef backoffice. The POST sent will contain the NIT needed to proceed with the recharge;
    • 1.2. The response of the store to the HTTPS POST must be "200 OK";
    • 1.3. The e-SiTef response to the begin recharge call will be a code indicating success (value 0) or failure (any value other than 0);
  • 2. The store must then make a call to list dealers passing the previously received NIT;
    • 2.1. e-SiTef returns a list containing the data of the dealers;
  • 3. The store must then make a call to list branch data by passing the chosen dealer code, the desired area code (DDD), and the NIT;
    • 3.1. e-SiTef returns the branch data, including possible recharge amounts, expiration periods, bonus amounts, among others;
  • 4. The store must then make a call to perform recharge passing the NIT, the chosen dealer code, the phone number, the area code (DDD) and the selected value;
    • 4.1. e-SiTef performs the recharge with the chosen dealer and returns the data of the recharge pending confirmation;
  • 5. The store must always make a call to confirm the recharge passing the NIT and a field indicating if the pending recharge must be confirmed or undone on the dealer;
    • 5.1. e-SiTef returns a response indicating the result of the confirmation or undoing of the recharge;

Recharge flow with payment

The recharge flow with or without payment is the same, with the addition that the payment flow requires that the payment data is sent on the recharge call.

← Schedule editing serviceQuick start →
  • Overview
  • Communication
  • Recharge flow without payment
  • Recharge flow with payment
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