Construcción de Soluciones de TI

ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 28/02/2018
por

Especificación Funcional

Especificaciones DigitalAbstract

Versión : 1.0

Fecha : 28 de Febrero de 2018

Copyright : ATH SA
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 28/02/2018
por

All rights reserved.

Nota De Confidencialidad
Derechos Reservados © 2018, ATH SA.
No esta permitida la reproducción total o parcial de este documento, ni su tratamiento
Informático, ni la transmisión de ninguna forma o por cualquier medio, ya sea
Electrónico, mecánico, por fotocopia, por registro u otros métodos, sin el permiso previo
y por escrito de los titulares del Derecho de Autor (Copyright).
A TODA HORA S.A. (Colombia)
Calle 100 No. 13-21
Bogotá, Colombia
Sur América
Teléfonos +571-7541616
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 28/02/2018
por

Registro de Cambios al Documento

Versión Fecha Descripción del Cambio Autor

Creación del documento de Eduardo E.
1.0 01/07/2015 especificación Rincón

Para el campo s103 en el indicador clase

de pago se eliminan los valores 3, 4 y 5. Jorge Andres
2.0 15/09/2015
Para tarjeta de crédito quedara 0 o 1 y Ñustes
para cartera 2

Se incluye procesing code para pago de Edward Alonso

3.0 13/11/2015
tarjeta de crédito cara adquiriente. Tejedor

Se incluye la identificación de la
4.0 28/12/2015 terminal exclusiva para Portal de Pagos Andres Camacho
que viaja en campo 41.

Se consolida la información de las dos Jesús David

5.0 13/07/2017
versiones documentos. Ibarra Rodríguez

Se ajusta según la información remitida

Jesús David
5.1 17/07/2017 por Desarrollo Switch y Desarrollo
Ibarra Rodríguez
Integración.

Se ajusta información que viajará en los Jesús David

5.2 24/07/2017
campos P35 y P103. Ibarra Rodríguez

Luis Esteban
Redacción en formato para proyecto
6.0 29/02/2018 Cordoba Chivata
Update Postilion
(Proveedor)
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 28/02/2018
por

CONTENIDO:

CONSIDERACIONES ....................................................................................................................................... 6

Pagos aval y Tarjetas de crédito ......................................................................................................... 7

Bitmap´s ................................................................................................................................................ 7

Flujo transaccional ................................................................................................................................ 7

Mensajería ............................................................................................................................................ 8

Trace Producción ................................................................................................................................ 15

Diagrama de contexto............................................................................................................................. 17

Premisas y Supuestos.............................................................................................................................. 18

Manejo de integridad transaccional ....................................................................................................... 18

Manejo de fecha de negocios ................................................................................................................. 20

BINES a Procesar ..................................................................................................................................... 20

TRANSACCIONES ADMINISTRATIVAS .......................................................................................................... 21

PAGO DE OBLIGACIONES DIFERENTE A TC (SE ENRUTA A BOCC) ............................................................... 21

P03 - Processing Code ......................................................................................................................... 21

P32 - Código de Identificación de la Institución Adquiriente ............................................................. 22

P35 - TRACK-II...................................................................................................................................... 22

P41 - Identificación de la Terminal Adquiriente ................................................................................. 23

S102 - Número de Cuenta ................................................................................................................... 23

S103 – Datos de la cuenta Adicional ................................................................................................... 23

PAGO DE TARJETA DE CRÉDITO (SE ENRUTA A FD) .................................................................................... 24

P03 - Processing Code ......................................................................................................................... 25

 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 28/02/2018
por

P32 - Código de Identificación de la Institución Adquiriente ............................................................. 25

P35 - TRACK-II...................................................................................................................................... 25

P41 - Identificación de la Terminal Adquiriente ................................................................................. 26

P63 – TAGS Datos Adicionales ............................................................................................................ 26

 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 28/02/2018
por

CONSIDERACIONES
DigitalAbstract

 Backend Parcial

 Únicamente pagos de crédito rotativo, otros créditos y tarjetas de crédito del banco de Occidente

 Los pagos de obligación: Credito rotativo y otros créditos, son autorizados por EchOccAut

 Los pagos de tarjeta de crédito son autorizados por ChFirstData

 Tener en cuenta que el campo p32, p35 y p41.

Proceso Configuración
Llave PIN NO

IDDL NO

Lllave MAC NO

protocol_header_in NO

protocol_header_out NO

auto_signon SI

signon_interval SI
c/min
Manejo SAF SI

Configuración conexión Client

user_parms '-X'
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 28/02/2018
por

Pagos aval y Tarjetas de crédito

Bitmap´s

PAGOS, AVANCES CON ABONO A CUENTA Y TRANSFERENCIAS

MENSAJE BITMAP

200 BMAP PRI = B238840128A09010

BMAP SEC = 0000000007000001

210
BMAP PRI = B23884012E80801A
BMAP SEC = 0000000017000001

420
BMAP PRI = B23880012EA08018
BMAP SEC = 0000004217000001

430
BMAP PRI = B22000012A808000
BMAP SEC = 0000004200000001

Flujo transaccional

Pago de obligación Backend Parcial

0200 0200
Transaction
Adquiriente
Manager EchOccAUT
EchEntidad 0210 0210
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 28/02/2018
por

Pago de TC Backend Parcial

0200 0200
Transaction
Adquiriente
Manager ChFirstData
EchEntidad 0210 0210

Mensajería
Cod. Descripción Tipo Lon Observaciones
de g.
Camp
o

P3 Processing Code N 6  Pagos 50XXYY

Donde

XX :

- 10 : Ahorros
- 20: Corriente
YY :
- 30 : Tarjeta de crédito
- 40 : Crédito rotativo
- 41 : Otros Créditos

P4 Valor de la transacción N 12 Corresponde al valor en pesos de la transacción con dos

decimales.

P7 Fecha y hora N 10 MMDDHHMMSS

transmisión

P11 Número de Auditoria N 6 Número de referencia o consecutivo del mensaje.

(System Trace Audit
Number)

P12 Hora Local N 6 Hora local manejada por el dispositivo de captura (terminal).

Formato : hhmmss
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 28/02/2018
por

P13 Fecha Local N 4 Fecha local de captura.

Formato : MMDD

P17 Fecha de N 4 Asignada por el adquirente.

Compensación
Formato : MMDD

P32 ID Entidad Adquiriente N 13 2 Posiciones longitud fija (11)

11 Id Entidad

10000000023 : Bco. Occidente

Se hace passthrough hacia el autorizador ó procesos

involucrados en la transacción.

P35 TRACK II DATA AN 39 2 Posiciones longitud (37 fija).

Para pagos/transferencias originados desde Internet, IVR

este campo está conformado por :

6 dígitos correspondientes a un pseudo BIN que identifica a

cada entidad adquirente:

Para Extracto digital:

Pago de TC: 008823

Pago AVAL: 008899

X dígitos con el número de la cuenta de máximo 18

posiciones. (En este escenario siempre viaja en 0)

1 posición con un separador (=).

1 posición para indicar :

0 : Transacción Banca Personal
1 : Transacción Banca Empresarial
2 : Transacción Banca Móvil

X posiciones espacios/ceros/información del adquirente

hasta completar los 37 de la longitud.

Se hace passthrough hacia el autorizador ó procesos

involucrados en la transacción.

P37 Número de Referencia N 12 Número único de identificación de la transacción.

Se hace passthrough hacia el autorizador ó procesos

involucrados en la transacción.
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 28/02/2018
por

P38 Número de N 6 Código de Autorización asignado por la Entidad

Autorización autorizadora.

P39 Response Code N 2 Código de resultado

Código de declinación de la Entidad autorizadora, que

obliga a revisar el campo P63 para obtener el código y
descripción real de declinación.

P41 Terminal ID AN 16 Identificación de dispositivo o terminal

4 Posiciones con ID Adquiriente

4 Posiciones con ID terminal

4 filler (espacios ó ceros)

1 Posición para identificador del canal (2: Internet; 5: IVR)

Ejemplo:

[00548128 2 ]

(Los paréntesis cuadrados no hacen parte del campo)

NOTA : No todas las Entidades envían el indicador.

Se hace passthrough hacia el autorizador ó procesos

involucrados en la transacción.

P43 Nombre y localización AN 40 22 primeras posiciones, identifican el canal, así:

del capturador
4 Dígitos: Código

18 Caracteres : Nombre

13 Caracteres : Código del DANE de la ciudad justificado a

la izquierda.

5 Posiciones en blanco.

Se hace passthrough hacia el autorizador ó procesos

involucrados en la transacción.

P49 Código de la moneda N 3 Valor 170

P52 PIN AN 16 B. Bogotá : FFFFFFFFFFFFFFFF

B. Popular : FFFFFFFFFFFFFFFF

B. AVVillas : La Entidad envía un cryptograma comodín, sin

 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 28/02/2018
por

embargo no se debe hacer translate de pin.

B. Occidente : FFFFFFFFFFFFFFFF

Se hace passthrough hacia el autorizador ó procesos

involucrados en la transacción.

P60 Información de la AN 15 15 posiciones alfanuméricas incluidas 3 de longitud (012).

terminal
Por configuración según proceso.

P61 Información del AN 16 16 posiciones alfanuméricas incluidas 3 de longitud (013).

autorizador

P63 Error de la Entidad AN 047 3 Posiciones longitud (044 fija)

4 Posiciones numéricas que indican el código de error de la

Entidad autorizadora. Si la transacción es exitosa algunas
Entidades envían el código 0000.

40 Posiciones con la descripción del error. Si la transacción

es exitosa algunas Entidades envían el mensaje:
TRANSACCION EXITOSA. Este campo algunas veces es
enviado en espacios por las Entidades.

S90 Datos originales de la N 42 4 Posiciones para identificación del mensaje original.

(**) transacción (“0200”)

12 Posiciones para el número de secuencia de la

transacción original. (“P37”)

4 Posiciones con la fecha de la transacción original

(MMDD).

8 Posiciones con la hora de la transacción (HHMMSSmm).

4 Posiciones con la fecha de compensación de la

transaccion (MMDD).

10 Posiciones en cero.

S95 Replacement Amount N 42 Ceros

S100 Código Entidad AN 11 Receive institution id

Autorizadora
B. AVVillas '10000000140'
B. Bogotá '10000000001'
B. Popular '10000000002'
B. Occidente '10000000023'

S102 No. Cuenta AN 20 23 Posiciones alfanuméricas incluidas 2 de la longitud (21).

4 Posiciones con el código de compensación de la entidad
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 28/02/2018
por

dueña de la cuenta.

- 0023 : B. Occidente

17 Posiciones con el número de la cuenta justificada a la

derecha. (En este escenario siempre es 0)

S103 Características de la 26 posiciones alfanuméricas incluidas 2 de la longitud (24).

transacción

1 Posición para la clase de pago:

- 0 Pesos (Consumo nacional Occ.)

- 1 Dólares (Consumo exterior Occ.)

- 2 Aplicación cartera por pago NORMAL

- 3 Aplicación cartera por pago ABONO PROXIMAS

CUOTAS

- 4 Aplicación cartera por pago ABONO DISMINUIR

CUOTA

- 5 Aplicación cartera por pago ABONO DISMINUIR

PLAZO

1 Posición para el tipo de pago :

0 De la misma entidad

1 Otra entidad

1 Posición para el tipo de movimiento:

0 Débito

1 Crédito

2 Mixta

Consideración

En este campo el adquirente informa a ATH (mensaje 0200)

la parte a resolver primero (Débito/Crédito/Mixto).

Las Entidades adquirentes que son Backend total informan

que se resuelva primero el débito (0).

Las Entidades adquirentes que son Backend parcial

informan que se resuelva el crédito (1).

En una transferencia InterAval, ATH debe indicar a la

 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 28/02/2018
por

Entidad crédito el flag correspondiente (1).

4 Posiciones para el código de compensación de la

entidad crédito:

Bogotá 0001

Occidente 0023

Popular 0002

Av Villas 0052

Para el caso de las transferencias ACH, en este campo va

el código del Banco al cual se dirigen los fondos.

17 Posiciones con el número de la cuenta justificada a

la derecha.

Para transferencias con destino ACH, el número de cuenta

va justificado a la izquierda y relleno con espacios a la
derecha.

Consideraciones:

Ejemplo: 002002300000000774745337

**IMPORTANTE
Las tres primeras posiciones quedarán fijas.

S104 Account Identification AN 20 20 Posiciones alfanuméricas incluidas 2 de la longitud (18).

18 posiciones con justificación a la derecha.

1 Posición con el TIPO de documento del titular de la

cuenta debitada, así :

0 Cédula de ciudadanía
1 Nit Jurídico
2 Cédula de extranjería
3 Tarjeta de identidad
4 Pasaporte
5 Registro Civil
6 Nit Persona Natural
7 Nit Extranjeros
8 Tarjeta de seguro social extranjero
9 Sociedad extranjera sin NIT

17 Posiciones con el número del documento del titular de la

cuenta debitada.

Nota: Si la inscripción de cuenta ya fue validada en el

débito, este campo viajará en cero.

S105 Verificación tarjeta N 28 28 Posiciones alfanuméricas incluidas 3 de la longitud

(025).
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 28/02/2018
por

corresponsal Ceros.

S126 Token ANS 54 Este token es utilizado para enviar información adicional y
requerida para procesar como el código de proceso de la
transacción financiera, el número de secuencia de la
transacción original, el costo de la transacción y estado.
Estructura adicional

S128 MAC ANS 54 28 Posiciones alfanuméricas incluidas 3 de la longitud

(025).

Ceros.

Campo s126
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 28/02/2018
por

Trace Producción

Pago de Tarjeta de crédito

[Nov 23 09h24:02.106] - <0200> Message received at DigitalAbstractSap1 [23/11/2017 - 09:23:59.886]
[Fix:__' ' ans 003 M] : 'Iso' = [ISO]
[Fix:' '__ n 002 M] : 'Product' = [01]
[Fix:' '__ n 002 M] : 'Release' = [40]
[Fix:' '__ n 003 M] : 'Status' = [000]
[Fix:__' ' n 001 M] : 'Originator' = [5]
[Fix:__' ' n 001 M] : 'Responder' = [0]
0200:
[Fixed n 6 006] 003 [502030]
[None n 012] 004 [000002316826]
[Fixed n 10 010] 007 [1123092401]
[Fixed n 6 006] 011 [359449]
[Fixed n 6 006] 012 [092401]
[Fixed n 4 004] 013 [1123]
[Fixed n 4 004] 017 [1123]
[Fixed n 3 003] 022 [010]
[LLVAR ans ..11 011] 032 [10000000023]
[LLVAR ans ..37 037] 035 [008823**************0000=0000********]
[Fixed anp 12 012] 037 [112309235944]
[Fixed ans 16 016] 041 [0054812800002 ]
[Fixed b 40 040] 043 [ATH InternetbBOCC 0000000BOGOTACUNCO]
[Fixed a/n 3 003] 049 [170]
[Fixed an 16 016] 052 [****************]
[LLLVAR b ..920 012] 060 [TRANSACTOR ]
[LLVAR ans ..28 021] 102 [*********************]
[LLVAR ans ..28 024] 103 [************************]
[LLVAR b ..24 018] 104 [000000000000000000]
[LLLVAR b ..999 054] 126 [& 0000200054! QT00032 5020300000000000000000000000000.]

[Nov 23 09h24:02.106] - <0210> Message sent from DigitalAbstractSap1 [23/11/2017 - 09:24:00.274]

[Fix:__' ' ans 003 M] : 'Iso' = [ISO]
[Fix:' '__ n 002 M] : 'Product' = [01]
[Fix:' '__ n 002 M] : 'Release' = [40]
[Fix:' '__ n 003 M] : 'Status' = [000]
[Fix:__' ' n 001 M] : 'Originator' = [5]
[Fix:__' ' n 001 M] : 'Responder' = [0]
0210:
[Fixed n 6 006] 003 [502030]
[None n 012] 004 [000002316826]
[Fixed n 10 010] 007 [1123092401]
[Fixed n 6 006] 011 [359449]
[Fixed n 6 006] 012 [092401]
[Fixed n 4 004] 013 [1123]
[Fixed n 4 004] 017 [1123]
[Fixed n 3 003] 022 [010]
[LLVAR ans ..11 011] 032 [10000000023]
[LLVAR ans ..37 037] 035 [008823**************0000=0000********]
[Fixed anp 12 012] 037 [112309235944]
[Fixed ans 6 006] 038 [C08531]
[Fixed an 2 002] 039 [00]
[Fixed ans 16 016] 041 [0054812800002 ]
[Fixed a/n 3 003] 049 [170]
[LLLVAR b ..920 012] 060 [TRANSACTOR ]
[LLLVAR ans ..19 013] 061 [0054PRO3 ]
[LLLVAR b ..144 044] 063 [0000TRANSACCION EXITOSA ]
[LLVAR ans ..11 011] 100 [10000000023]
[LLVAR ans ..28 021] 102 [*********************]
[LLVAR ans ..28 024] 103 [************************]
[LLVAR b ..24 018] 104 [000000000000000000]
[LLLVAR b ..25 025] 105 [0000000000000000000000000]
[LLLVAR b ..999 054] 126 [& 0000200054! QT00032 5020300000000000000000000000000.]

Pago de obligación
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 28/02/2018
por

[Nov 23 09h24:02.106] - <0200> Message received at DigitalAbstractSap1 [23/11/2017 - 09:23:59.886]

[Fix:__' ' ans 003 M] : 'Iso' = [ISO]
[Fix:' '__ n 002 M] : 'Product' = [01]
[Fix:' '__ n 002 M] : 'Release' = [40]
[Fix:' '__ n 003 M] : 'Status' = [000]
[Fix:__' ' n 001 M] : 'Originator' = [5]
[Fix:__' ' n 001 M] : 'Responder' = [0]
0200:
[Fixed n 6 006] 003 [502040]
[None n 012] 004 [000002316826]
[Fixed n 10 010] 007 [1123092401]
[Fixed n 6 006] 011 [359449]
[Fixed n 6 006] 012 [092401]
[Fixed n 4 004] 013 [1123]
[Fixed n 4 004] 017 [1123]
[Fixed n 3 003] 022 [010]
[LLVAR ans ..11 011] 032 [10000000023]
[LLVAR ans ..37 037] 035 [008899**************0000=0000********]
[Fixed anp 12 012] 037 [112309235944]
[Fixed ans 16 016] 041 [0054812800002 ]
[Fixed b 40 040] 043 [ATH InternetbBOCC 0000000BOGOTACUNCO]
[Fixed a/n 3 003] 049 [170]
[Fixed an 16 016] 052 [****************]
[LLLVAR b ..920 012] 060 [TRANSACTOR ]
[LLVAR ans ..28 021] 102 [*********************]
[LLVAR ans ..28 024] 103 [************************]
[LLVAR b ..24 018] 104 [000000000000000000]
[LLLVAR b ..999 054] 126 [& 0000200054! QT00032 5020300000000000000000000000000.]

[Nov 23 09h24:02.106] - <0210> Message sent from DigitalAbstractSap1 [23/11/2017 - 09:24:00.274]

[Fix:__' ' ans 003 M] : 'Iso' = [ISO]
[Fix:' '__ n 002 M] : 'Product' = [01]
[Fix:' '__ n 002 M] : 'Release' = [40]
[Fix:' '__ n 003 M] : 'Status' = [000]
[Fix:__' ' n 001 M] : 'Originator' = [5]
[Fix:__' ' n 001 M] : 'Responder' = [0]
0210:
[Fixed n 6 006] 003 [502040]
[None n 012] 004 [000002316826]
[Fixed n 10 010] 007 [1123092401]
[Fixed n 6 006] 011 [359449]
[Fixed n 6 006] 012 [092401]
[Fixed n 4 004] 013 [1123]
[Fixed n 4 004] 017 [1123]
[Fixed n 3 003] 022 [010]
[LLVAR ans ..11 011] 032 [10000000023]
[LLVAR ans ..37 037] 035 [008899**************0000=0000********]
[Fixed anp 12 012] 037 [112309235944]
[Fixed ans 6 006] 038 [C08531]
[Fixed an 2 002] 039 [00]
[Fixed ans 16 016] 041 [0054812800002 ]
[Fixed a/n 3 003] 049 [170]
[LLLVAR b ..920 012] 060 [TRANSACTOR ]
[LLLVAR ans ..19 013] 061 [0054PRO3 ]
[LLLVAR b ..144 044] 063 [0000TRANSACCION EXITOSA ]
[LLVAR ans ..11 011] 100 [10000000023]
[LLVAR ans ..28 021] 102 [*********************]
[LLVAR ans ..28 024] 103 [************************]
[LLVAR b ..24 018] 104 [000000000000000000]
[LLLVAR b ..25 025] 105 [0000000000000000000000000]
[LLLVAR b ..999 054] 126 [& 0000200054! QT00032 5020300000000000000000000000000.]
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 28/02/2018
por

Diagrama de contexto

A continuación se detalla a nivel general, la forma en que interactúan los sistemas para la autorización y
procesamiento de las transacciones desde que se adquiere en el Portal de Pagos hasta el momento en
que es enviado a FD o la Entidad para su autorización.

Pago de TC – Cara Debito

ACH

1. Cara Debito

ACH

2. Cara Credito

Portal Pagos Bus de

Pago de
Servicios
obligación con
PSE
ATH

Core Banco

Triara

Pago Obligación
diferente a TC

Base 24
Pago Obligación
de TC

Zona Franca

Server Postilion

ATH
Pago de TC – Cara Credito
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 29/02/2018
por

Premisas y Supuestos

o A nivel transaccional se manejara 3 llaves de cifrado (KEK, MAC y PIN) con el fin de
garantizar la integridad del mensaje desde el canal adquiriente hasta el autorizador.
o A nivel de compensación las transacciones serán notificadas a Banco de Occidente a
través de las cintas que actualmente se manejan y será la entidad quien realice al
interior los procesos de compensación.
o ATH a nivel interno cuenta con dos servidores bajo el esquema Activo/Activo, quienes
se encargan de procesar y enrutar las transacciones a los respectivos autorizadores.
o Las transacciones a procesar serán Pago de Tarjeta de Crédito, Pago de crédito
rotativo y Pago de otros créditos, todas ellas adquiridas por el Portal de Pagos y enruta
a Postilion por el Bus de Servicios de ATH.
o ATH enviara la transacción al Core de Banco de Occidente bajo la mensajería que
actualmente se intercambia y a FD bajo la misma premisa.
o Solo se enviara a FD y/o Banco de Occidente la cara crédito de las transacciones,
actuando bajo el esquema de Backend Parcial, ya que la cara debito será previamente
procesada y autorizada por ACH donde no hay participación del Postilion de ATH.

Manejo de integridad transaccional

ATH manejara la integridad de la transacción entre Postilion y entidad autorizadora. Es

importante tener en cuenta que estas transacciones cuentan con reverso automático en
línea para garantizar la integridad transaccional. Este reverso será enviado por ATH a
Banco de Occidente o First Data sea el caso y serán ellas quienes al interior reversen la
transacción, pues para el cliente ya se encuentra declinada.

ATH dentro de su esquema de reversos manejara 2 escenarios globales los cuales se

describen a continuación:

18
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 29/02/2018
por

Reverso Cara Crédito

Este reverso corresponde a la segunda cara de la transacción frente al autorizador. En este

caso ATH envía la transacción a la entidad que debe aprobar la cara crédito, previa
autorización exitosa de la cara débito por parte de ACH. Si la entidad no responde dentro
del tiempo establecido (Timeout), ATH declina la transacción de cara al adquiriente (Portal
de Pagos) para mantener la integridad y posteriormente realiza alguno de los siguientes
pasos:

o Si la transacción es contestada por la entidad crédito de manera exitosa después del

Timeout, ATH envía un reverso automático al autorizador para que sea procesado,
manteniendo la integridad de la transacción.
o Si la transacción es contestada por la entidad crédito de manera no exitosa (Declinación de
cualquier tipo), ATH no envía reverso al autorizador y da por cerrada la transacción.
o Si la transacción nunca es contestada por la entidad crédito (Temas de comunicación,
encolamientos y demás), ATH no envía reverso al autorizador, da por cerrada la
transacción y ya será en los procesos de compensación que se realizan a nivel Batch donde
entrara a ajustarse la diferencia.

Reverso Canal Adquiriente (Portal de Pagos)

Este reverso se origina desde el canal que adquiere la transacción (Portal de Pagos). En
este caso ATH envía la transacción de reverso a la entidad que aprobó la cara crédito, ya
sea FD para pago de Tarjeta de crédito o Banco de Occidente para los otros tipos de
obligaciones, se procesa la transacción al interior y envía al adquiriente (Portal de Pagos)
respuesta exitosa del reverso con el fin de mantener la integridad transaccional.

En este caso Postilion no enviara reverso al autorizador de la cara débito, pues el Portal de
Pagos a través de sus sistemas internos será el encargado de esto.

19
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 29/02/2018
por

Manejo de fecha de negocios

Actualmente ATH maneja dos fechas dentro de sus transacciones. Fecha de la transacción
en línea (local) y fecha de compensación. A continuación detallamos la información que se
maneja en la fecha de compensación:

 ATH realiza el corte de todos sus módulos a las 21:00 por todos sus canales,
independientemente del día.
 El corte para este canal se realiza por fecha calendario, colocando la fecha del
siguiente día, independientemente de si son fines de semana o días festivos.
 Entre las 00:00 y las 21:00 la fecha de negocio es la misma fecha local y posterior a
esta hora quedara la fecha de compensación es la del siguiente día.

Esta fecha de compensación es de vital importancia para los procesos Batch al interior de
ATH y las entidades, ya que las transacciones que se reportan en las noches para su
procesamiento son las que fueron adquiridas en ese día hasta la hora de corte (21:00).

BINES a Procesar
Como la transacción es adquirida por el canal de Internet (Portal de Pagos) el Bin que se
maneja en este tipo de transacciones para su enrutamiento es el siguiente:

Bin Pago TC PseudoBIN (Otros

Obligaciones)

008823 008899

20
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 29/02/2018
por

TRANSACCIONES ADMINISTRATIVAS

Por cada una de las conexiones establecidas entre ATH, Banco de Occidente y FirstData se
manejara, adicional a la mensajería financiera, transacciones administrativas que nos
permitirán establecer la conexión, mantener la conexión activa y/o realizar intercambios
de llaves entre otras.

Como premisa serán las mismas transacciones que ya actualmente se manejan por la
conexión autorizadora de internet de Banco de Occidente y la conexión autorizadora de
internet de First Data. (Esto no sufre ninguna modificación).

PAGO DE OBLIGACIONES DIFERENTE A TC (SE ENRUTA A BOCC)

Para la transacción de Pago de Obligaciones de Crédito Rotativo y Otros Créditos se maneja la

misma mensajería que actualmente se tiene para las transacciones que se adquieren por Internet
y que son enviadas a la entidad para su procesamiento a excepción de los siguientes campos los
cuales cuentan con las siguientes particularidades:

P03 - Processing Code

6 posiciones numéricas
Indica el código de proceso de la transacción:

Pago Crédito Rotativo (Banco de Occidente):

501040: Cuenta Ahorros
502040: Cuenta Corriente

Pago de Otros Créditos (Banco de Occidente):

501041: Cuenta Ahorros
502041: Cuenta Corriente
21
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 29/02/2018
por

Pago de Tarjeta de Crédito (Banco de Occidente):

501030: Cuenta Ahorros
502030: Cuenta Corriente

P32 - Código de Identificación de la Institución Adquiriente

13 posiciones numéricas.
02 posiciones con la longitud (11).
11 posiciones con la información del campo:

Para transacciones adquiridas en cajeros ATH el valor será:

10000000023: Código que identifica a Banco de Occidente como adquiriente.

P35 - TRACK-II
39 posiciones alfanuméricas.
2 Posiciones con la longitud (37).
37 Posiciones con la información del TRACK-II de la tarjeta

Para caso de Banco de Occidente se enviara el mismo BIN que actualmente se envía para
las transacciones adquiridas por el canal de Internet, pero la cuenta a debitar al final del
PAN se enviara en ceros teniendo en cuenta que no llega del canal adquiriente:

Banco de Occidente:

Posición Posición
Descripción
Inicial Final

En las primeras 6 posiciones (BIN) se identifica la entidad dueña del

plástico. En este caso viajara 008823 (Bin Pago tarjeta Crédito) y
1 24
008899 (Otras Obligaciones) y las siguientes posiciones se enviara
ceros hasta completar el campo.

25 25 Separador de campo (=)

26 37 Ceros hasta completar la longitud del campo.

Ejemplo: 008899000000000000000000=000000000000

22
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 29/02/2018
por

En el mensaje enviado de Postilion a FirstData se le enviara tal como viaja actualmente,

donde el PAN es el número de la tarjeta de Crédito a la cual se le está realizando el Pago,
luego viene el separador de campo, la fecha de vencimiento como 9912 y ceros hasta
completar la longitud.

Ejemplo: 4899118185648108D99120000000000000000

P41 - Identificación de la Terminal Adquiriente

16 posiciones alfanuméricas (ANS).

4 posiciones con la identificación de la red o Banco adquiriente:

0054: para terminales administradas por ATH

4 posiciones con la identificación de la Terminal (Sera 8128, única para el canal de

Portal de Pagos). Con este código se deberá identificar la transacción tanto en línea
como en Batch.
4 posiciones con ceros.
4 posiciones con espacios

En la posición 13 del P41 se identificara el canal donde se originó la transacción.

Para este caso se enviara 2 indicando que la transacción se originó desde el canal
de Internet.

Ejemplo: [00548128 2 ] (Los paréntesis cuadrados no hacen parte del campo)

S102 - Número de Cuenta

23 posiciones alfanuméricas (ANS).
Contiene la información de la cuenta a debitar.

02 Posiciones con la longitud (21)

04 Posiciones con el código de Compensación de la entidad dueña de la cuenta.
17 Posiciones con el número de cuenta a la que se debe debitar. Como en este
caso no se conoce, se enviara ceros a la entidad.

S103 – Datos de la cuenta Adicional

26 posiciones alfanuméricas (ANS).
23
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 29/02/2018
por

02 Posiciones con la longitud (24)

01 Posición con el Indicador de clase de Pago:
0: Pesos (Consumo nacional Occidente) y para Retiros en CNB
1: Dólares (Consumo exterior Occidente)
2: Aplicación cartera por pago Normal

01 Posición con el Tipo:

0: De la misma entidad
1: Otra entidad

01 Posición con el tipo de movimiento:

0: Débito
1: Crédito
2: Mixta

04 Posiciones con el Código de compensación del Banco crédito:

0001: Banco de Bogotá
0002: Banco Popular
0023: Banco de Occidente
0052: Banco AV Villas

17 Posiciones con el número de la obligación a pagar, justificado a la derecha y

relleno de ceros a la izquierda.

Ejemplo: 002002300000000774745337

**IMPORTANTE
Las tres primeras posiciones quedarán fijas.

PAGO DE TARJETA DE CRÉDITO (SE ENRUTA A FD)

Para la transacción de Pago de Tarjeta de Crédito se maneja la misma mensajería que actualmente
se tiene para las transacciones que se adquieren por Internet y que son enviadas a FirstData para
su procesamiento a excepción de los siguientes campos los cuales cuentan con las siguientes
particularidades:

24
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 29/02/2018
por

P03 - Processing Code

6 posiciones numéricas
Indica el código de proceso de la transacción:

Pago de Tarjeta de Crédito (First Data):

200030: Pago de TC.

P32 - Código de Identificación de la Institución Adquiriente

13 posiciones numéricas.
02 posiciones con la longitud (11).
11 posiciones con la información del campo:

Para transacciones adquiridas en cajeros ATH el valor será:

10000000023: Código que identifica a Banco de Occidente como adquiriente.

P35 - TRACK-II
39 posiciones alfanuméricas.
2 Posiciones con la longitud (37).
37 Posiciones con la información del TRACK-II de la tarjeta

Para caso de First Data el campo P35 no sufre modificaciones y se enviara tal como se
envía en estos momentos para la transacción de Pago de Tarjeta de Crédito adquirida por
Internet.

Posición Posición
Descripción
Inicial Final

1 16 Viaja el PAN de la tarjeta de crédito que se está pagando.

17 17 Separador de campo (D)

18 21 Fecha de vencimiento (9912)

22 37 Se envían ceros para completar la longitud del campo

Ejemplo: 4899118185648108D99120000000000000000

25
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 29/02/2018
por

Para el caso de FirstData se le enviara el campo P35 tal como viaja actualmente para la
transacción de pago de tarjeta de crédito adquirida por el canal de internet.

P41 - Identificación de la Terminal Adquiriente

16 posiciones alfanuméricas (ANS).

4 posiciones con la identificación de la red o Banco adquiriente:

0054: para terminales administradas por ATH

4 posiciones con la identificación de la Terminal (Sera 8128, única para el canal de

Portal de Pagos). Con este código se deberá identificar la transacción tanto en línea
como en Batch.
4 posiciones con ceros.
4 posiciones con espacios

En la posición 13 del P41 se identificara el canal donde se originó la transacción.

Para este caso se enviara 2 indicando que la transacción se originó desde el canal
de Internet.

Ejemplo: [0054812800002 ] (Los paréntesis cuadrados no hacen parte del campo)

P63 – TAGS Datos Adicionales

Para el caso de First Data actualmente en el Token Q7 se envía la información de la cuenta

donde se realizó el débito. Teniendo en cuenta que esta cuenta se desconoce desde el
canal adquiriente, a First Data se le enviara en ceros.

Campo Formato Descripción

Tarjeta PIC X(19) Ceros hasta completar las 19 posiciones

Cuenta PIC X(28) Número de la cuenta debito

Filler PIC X(31) Espacios hasta completar las 31 posiciones

Ejemplo Q700078 000000000000000000000000000000000000000000000000000000000000000000000000000000

26
 Construcción de Soluciones de TI
ESPECIFICACIÓN PLATAFORMA
Aprobado
Código: NA Fecha 29/02/2018
por

Ejemplo total de un campo 63:

[& 0000800408! 0400020 00000000000 Y0! BM00036 Q401501030

00000000000000000000! C000026 2 0 ! C400012 1 25100 600! Q400122
000000000000000000000000000000000000000000000000000000000000000000000230
00000000000000017000051400000000000000000000000000! Q700078
000000000000000000000000000000000000000000000000000000000000000000000000
000000! QT00032 50103000000000000000000000000000]

Todos los demás campos de la mensajería para la transacción de Pago de Tarjeta de

Crédito, Pago de crédito rotativo y otros créditos, se comporta bajo los mismo
lineamientos y definiciones de estas transacciones cuando son adquiridas por el canal de
Internet, ya sea en el mensaje que se envía a FirstData como el que se envía a Banco de
Occidente.

27