Interface Com Operadora

Interface com Operadora
Verso
Data
1.0
10/06/2014
CONTROLE DE VERSES
Responsvel
Descrio
Criao do
documento no
template Rede
Ivo Henrique
utilizando como base
documento utilizado
pela ex E-capture.
rea
Sistemas de
Parcerias.
ndice
1.
Conceitos gerais........................................................................................................................... 2
2.
Fluxo de mensagens .................................................................................................................... 3

2.1. Transao de Consulta de Valores ............................................................................................ 3
2.2. Transao de Recarga ............................................................................................................... 3
2.3. Transao de Desfazimento ....................................................................................................... 4
2.4. Transao de Sonda ................................................................................................................... 4
2.5. Transao de Eco ........................................................................................................................ 4
3. Formato das mensagens .................................................................................................................. 5

3.1
Consulta de Valores ............................................................................................................... 5
3.2
Transao de Recarga ........................................................................................................... 6
3.3
Transao de Desfazimento ................................................................................................... 9
3.4
Sonda ....................................................................................................................................11
3.5
Eco ........................................................................................................................................13
4. Detalhamento dos Campos ............................................................................................................14
4.1. Campo 39 (Cdigo de Resposta) ..............................................................................................14
4.2. Campo 62 ..................................................................................................................................15
4.3. Campo 32 ..................................................................................................................................16
4.4. Campo 42 ..................................................................................................................................16
1. Conceitos gerais
Todas as mensagens trocadas entre as Operadoras e a E-Capture estaro no
padro ISO-8583. O padro ISO-8583 caracteriza-se pelo seu formato genrico:
Cdigo da
Transao
Primeiro mapa de
bits
Cdigo da
Transao
Primeiro mapa de
bits
Dados da
Transao
ou
Segundo mapa de
bits
Dados da
Transao
onde:
- Cdigo da Transao um campo de 4 posies indicando o tipo de transao
(p.ex: 0800 = Abertura de seo);
- Mapa de bits so campos que codificam a presena ou no de determinados
sub-campos de dados no campo Dados da Transao. Quando um bit estiver
ligado significa que o sub-campo associado a ele est presente;
- Dados da Transao uma seqncia de sub-campos, sem delimitador entre
si, que definem os dados necessrios para a transao ou resposta.
Pela norma ISO-8583, os sub-campos so numerados de 2 a 128 e, de acordo
com o seu nmero, existe previamente um formato e definio de contedo
associado a ele. O bit 1 est reservado para indicar se existe ou no o segundo
mapa de bits.
Os campos podem ser numricos, alfanumricos e binrios. Os campos
numricos e alfanumricos possuem como contedo caracteres vlidos em
EBCDIC. J os campos binrios devem ser convertidos para EBCDIC no
procedimento de montagem da mensagem. A converso feita isolando-se cada
semi-byte do nmero e aplicando a tabela de converso:
0x00 ---> 0, ..., 0x09 ---> 9, 0x0a ---> A, ..., 0x0f ---> F
Os campos podem ser de tamanho fixo, LLVar ou LLLVar. Os de tamanho LL ou
LLL possuem o tamanho do campo de 00 a 99 ou 00 a 999 respectivamente. Este
tamanho vem na mensagem, antes do campo propriamente dito.
2
2. Fluxo de mensagens
Mostraremos os fluxos das mensagens entre a E-Capture e as Operadoras.
2.1. Transao de Consulta de Valores
E-Capture
Operadora
9200 - Solicitao
9210 - Resposta
2.2. Transao de Recarga
E-Capture
Operadora
0200 - Solicitao
0210 - Resposta
0202 - Confirmao
2.3. Transao de Desfazimento
E-Capture
Operadora
0420 - Solicitao
0430 - Resposta
2.4. Transao de Sonda
E-Capture
Operadora
0600 - Solicitao
0610 - Resposta
2.5. Transao de Eco
E-Capture
Operadora
0800 - Solicitao
0810 - Resposta
3. Formato das mensagens

3.1
Consulta de Valores
A consulta de valores feita em todo incio do dia contbil. Essa transao tem
como objetivo obter informaes sobre os valores de recarga que devem ser
aceitos, e outras caractersticas, como valor de bnus etc. Seu formato o
seguinte:
Solicitao (E-Capture Operadora)
Bit
3
7
11
12
13
32
42
Tamanh
o
(bytes)
4
16
6
10
6
6
4
LL
15
Tipo
N
B
N
N
N
N
N
N
A
Descrio
Cdigo da Transao (9200)

Primeiro mapa de bits
Cdigo de Processamento : 092000
Data/horrio da transmisso no formato MMDDhhmmss
Nmero seqencial da Transao
Hora local da transao no formato hhmmss
Data local da transao no formato MMDD
Cdigo da Instituio Financeira ver item 4.3
Cdigo origem da mensagem ver item 4.4
Resposta (Operadora E-Capture)

Bit
3
7
11
12
13
32
39
42
62
Tamanh
o
(bytes)
4
32
6
10
6
6
4
LL
2
15
LLL
Tipo
N
B
N
N
N
N
N
N
A
A
A
Descrio

Primeiro e segundo mapas de bits
Cdigo de resposta (00: aceito, <> 0 erro)
Dados da consulta - ver item 4.2
5
12
7
LLL
3.2
NSU Host (9 posies)
Transao de Recarga

Bit
Tipo
2
3
Tamanh
o
4
16
LL
6
4
7
12
10
N
N
11
12
13
22
6
6
4
3
N
N
N
N
32
37
LL
12
N
N
38
41
42
49
62
8
15
3
LLL
A
A
A
A
N
B
N
N
Descrio
Nmero do carto, somente p/ pagto com carto de TEF
Cdigo de Processamento : 002000 p/ pagto com carto de TEF
002040 p/ pagto sem carto de TEF
Valor total da compra
Data/horrio da trn p/ pagto sem carto de TEF(MMDDhhmmss)
Data/horrio da trn de TEF (MMDDhhmmss) p/ pagto com carto de
TEF
Modo de entrada (somente p/ pagto com carto de TEF) :
011 digitado
021 magntico
Nmero de referncia da transao(somente p/ pagto com carto de
TEF)
Nm. autoriz. gerado na trn de TEF(somente p/ pagto com carto de
TEF)
Identificao do terminal requisitante
Cdigo da moeda
Dados da recarga - ver item 4.2.

Bit
Tipo
2
3
4
7
Tamanh
o
4
32
LL
6
12
10
11
12
13
32
37
6
6
4
LL
12
N
N
N
N
N
38
39
41
42
49
62
12
7
2
8
15
3
LLL
LLL
A
A
A
A
A
N
N
B
N
N
N
N
Descrio
Primeiro e segundo mapa de bits
Valor
Data/horrio da trn p/ pagto sem carto de TEF(MMDDhhmmss)
Data/horrio da trn de TEF (MMDDhhmmss) p/ pagto com carto de
TEF
TEF)
TEF)
Cdigo de resposta (00: aceito, <> 0 erro) - ver item 4.1
Cdigo da moeda
Dados da recarga ver item 4.2
NSU Host (9 posies)
Confirmao (E-Capture Operadora)

Bit
Tipo
2
3
4
7
11
12
13
22
32
37
Tamanh
o
4
32
LL
6
12
10
6
6
4
3
LL
12
38
39
41
42
49
12
7
2
8
15
3
LLL
A
A
A
A
N
N
B
N
N
N
N
N
N
N
N
N
N
Descrio
Cdigo de processamento .
Valor
Hora da transao 0210 no formato hhmmss
Data da transao 0210 no formato MMDD
Modo de entrada
TEF)
TEF)
Cdigo de resposta (00: aceito, <> 0 erro) ver item 4.1
Cdigo da moeda
NSU Host (9 posies)
3.3
Transao de Desfazimento

Bit
Tipo
2
3
4
7
11
12
13
32
37
Tamanh
o
4
32
LL
6
12
10
6
6
4
LL
12
39
41
42
49
90
2
8
15
3
42
A
A
A
A
A
N
B
N
N
N
N
N
N
N
N
N
Descrio
Cdigo de Processamento : 002000 ou 002040
Valor total da compra
TEF)
Cdigo de resposta ver item 4.1
Cdigo da moeda
Dados da mensagem original :
cdigo da transao original N4 (0200)
nmero da transao original - bit 11 N6
hora da transmisso da transao original - bit 7 N10
cdigo da instituio financeira na transao original - bit 32 N11
caracteres 0 N11

Bit
Tipo
2
3
4
7
11
32
37
Tamanh
o
4
32
LL
6
12
10
6
LL
12
39
41
42
49
90
2
8
15
3
42
A
A
A
A
A
N
B
N
N
N
N
N
N
N
Descrio
Cdigo de Processamento : igual ao bit 3 da 0420
Valor
TEF)
Cdigo de resposta - ver item 4.1
Cdigo da moeda
Dados da mensagem original
10
3.4
Sonda
Solicitao (Operadora E-Capture)

Bit
7
11
12
13
32
37
41
42
12
5
12
7
Tamanh
o
4
32
10
6
6
4
LL
12
Tipo
8
15
LLL
A
A
N

Hora local da transao a ser consultada no formato hhmmss
Data local da transao a ser consultada no formato MMDD
Cdigo da Instituio Financeira
TEF)
Identificao do terminal executor da transao
Cdigo origem da mensagem (igual a 0200 original)
Nmero seqencial da transao a ser consultada (6 posies).
LLL
NSU do Host da transao a ser consultada (9 posies).
N
B
N
N
N
N
N
N
Descrio
Resposta (E-Capture Operadora)

Bit
7
11
12
13
32
37
39
41
42
12
5
Tamanh
o
4
32
10
6
6
4
LL
12
Tipo
2
8
15
LLL
A
A
A
N
N
B
N
N
N
N
N
N
Descrio
Cdigo da Instituio Financeira
TEF)
Cdigo origem da mensagem (identifica o lojista)
Nmero seqencial da transao a ser consultada (6 posies).
11
12
7
LLL
NSU do Host da transao a ser consultada (9 posies).
12
3.5
Eco
Solicitao (Operadora E-Capture)

Bit
7
11
12
13
32
42
Tamanh
o
4
16
10
6
6
4
LL
15
Tipo
N
B
N
N
N
N
N
A
Descrio
Hora local da transao a ser consultada no formato hhmmss
Data local da transao a ser consultada no formato MMDD
Cdigo da Instituio
Resposta (E-Capture Operadora)

Bit
7
11
12
13
32
39
42
Tamanh
o
4
16
10
6
6
4
LL
2
15
Tipo
N
B
N
N
N
N
N
A
A
Descrio
Cdigo da Instituio
13
4. Detalhamento dos Campos

4.1. Campo 39 (Cdigo de Resposta)
O cdigo de resposta pode assumir os seguintes valores:
00
03
Transao Aprovada
Cdigo de Estabelecimento invlido
09
Transao em processamento
77
Pendente de Confirmao
78
Transao Cancelada
80
Transao Inexistente
86
Transao Desfeita
N0
Recarga no permitida
N1
Erro na comunicao
N2
Cdigo Invlido
Efetuada
No
Efetuada
No
Efetuada
No
Efetuada
No
Efetuada
No
Efetuada
No
Efetuada
No
Efetuada
No
Efetuada
No
Efetuada
14
4.2. Campo 62
Transao ISO: 9210
. Efetuada:
- Qtde de valores fixos
02 bytes
- Valor 1
10 bytes
- Valor 2
10 bytes
...
- Valor n
10 bytes
- Permite Valor Varivel 01 byte (1 - permite / 0 - no permite)
- Valor Varivel - Mnimo 10 bytes
- Valor Varivel - Mximo 10 bytes
- Qtde de Bonus
02 bytes
- Bonus 1
10 bytes
- Bonus 2
10 bytes
...
- Bonus n
10 bytes
- Qtde de Info. Adicionais 02 bytes
- Informao 1
10 bytes
- Informao 2
10 bytes
...
- Informao n
10 bytes
- Campo de mensagem 64 bytes
. No efetuada
- Mensagem de Erro
64 bytes
Transao ISO: 0200
Contm informaes relacionadas recarga, no seguinte formato:
Tamanho da Informao 1
2
NN
Tipo da Informao 1
1
Ver abaixo
Contedo da Informao 1
1..98
Campo alfanumrico
...
Tamanho da Informao N
Tipo da Informao N
Contedo da Informao N
...
2
1
1..98
...
NN
Ver abaixo
Campo alfanumrico
Tipos de Informaes:
Tip Tamanh Descrio
o
o
T
1..20
Nmero do Telefone Completo (incluindo Cdigo de rea).
S
0..2
Sub-conta do Telefone
15
C
14
CNPJ da Origem da Recarga
Obs.:
Cada Tipo de Informao s pode ser enviado uma nica vez.
Cada operadora define a obrigatoriedade de envio de cada Tipo de
Informao.
Transao ISO: 0210
. Efetuada:
- Nova data de validade : DDMMAAAA
- Novo valor acumulado : N12
OU :
- F indicando que h texto formatado a seguir
- Mensagem de rodap do comprovante de recarga. Mudana de linha
sinalizada pelo
caracter @.
. No efetuada
- Mensagem de Erro
at 64 bytes
4.3. Campo 32
CCCCCRRRRRR
CCCCC : cdigo da operadora
RRRRRR : reservado para uso futuro (enviar zerado)
4.4. Campo 42
CCCCRREEEEELLLL
CCCC : Cdigo da E-Capture estabelecimento (1009)
RR : Reservado. Utilizado apenas para Bompreo:
Claro: 08
Vivo: 05
TIM: 00
Oi: 00
EEEEE : Cdigo do Estabelecimento
LLLL : nmero da loja
16

Interface Com Operadora

Hochgeladen von

Dokumentinformationen

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Interface Com Operadora

Hochgeladen von

Copyright:

Verfügbare Formate

Interface com Operadora

Fluxo de mensagens .................................................................................................................... 3

3. Formato das mensagens .................................................................................................................. 5

2.1. Transao de Consulta de Valores

2.2. Transao de Recarga

2.3. Transao de Desfazimento

2.4. Transao de Sonda

2.5. Transao de Eco

3. Formato das mensagens

Cdigo da Transao (9200)

Resposta (Operadora E-Capture)

Cdigo da Transao (9210)

NSU Host (9 posies)

Solicitao (E-Capture Operadora)

Resposta (Operadora E-Capture)

Confirmao (E-Capture Operadora)

Solicitao (E-Capture Operadora)

Resposta (Operadora E-Capture)

Solicitao (Operadora E-Capture)

Cdigo da Transao (0600)

NSU do Host da transao a ser consultada (9 posies).

Resposta (E-Capture Operadora)

NSU do Host da transao a ser consultada (9 posies).

Solicitao (Operadora E-Capture)

Resposta (E-Capture Operadora)

4. Detalhamento dos Campos

Das könnte Ihnen auch gefallen