Está en la página 1de 68

Certificación de desarrolladores

4/07/23 Creado por Bancard todos los derechos reservados. 1


INTEGRACIÓN DEL VPOS
En qué consiste el curso de integración:

• Descripción del ambiente de pruebas y producción del vpos.


• Flujo del Vpos.
• Descripción de cada API del servicio.
• Pruebas con SOAP UI del flujo.

Al finalizar deben tener chequeado toda la lista de test del vpos asignado para recibir el certificado de
Desarrolladores Certificados por Bancard.

4/07/23 Creado por Bancard todos los derechos reservados. 2


¿Qué es el VPOS?

Este servicio consiste en la autorización y captura en línea de transacciones de


compras vía internet, para comercios localizados en el país.

El servicio está compuesto de una conexión del comercio con Bancard y un


integrador del servicio WEB con el esquema actual de procesamiento de
transacciones.

4/07/23 Creado por Bancard todos los derechos reservados. 3


ESQUEMA DEL SERVICIO

4/07/23 Creado por Bancard todos los derechos reservados. 4


Ambiente de pruebas
Panel del VPOS
Bancard proporciona a sus comercios un ambiente de pruebas, donde pueden realizar sus pruebas de integración al servicio, el
ambiente es autogestionado. Para acceder al ambiente necesitan tener un código de comercio en Bancard y solicitar el servicio
del vpos.

En la pestaña de staging tienen lo que


denominamos la lista de test que es lo que
deben completar para acceder a la
certificación.

- Permisos de staging: Es lo primero que


tendrán en verde, ahí se muestra el día y
la hora en que se les habilitó los permisos
para acceder este panel.

- Ingreso de configuración del cliente:


Deben generar las claves publica y
privada, cargar la url de confirmación, el
logo.

- Ejecutar el cliente de prueba : Una vez


que utilicen el cliente de prueba para ver
cómo se implementan los servicios, se les
marcara.

4/07/23 Creado por Bancard todos los derechos reservados. 6


Panel del VPOS

Al generar nuevas claves, y completar el perfil ya tienen la mitad de la


lista de test chequeada!

4/07/23 Creado por Bancard todos los derechos reservados. 7


Panel del VPOS

También cuentan con la traza de actividad,


donde ahí podrán filtrar por fecha o shop
process id sus pruebas.
Podrán ver qué nos enviaron y qué les estamos
retornando, al hacer click en la prueba se
despliega un detalle de la prueba.

4/07/23 Creado por Bancard todos los derechos reservados. 8


Panel del VPOS

Pueden ver que datos se enviaron y que datos se


recibieron.
Pueden verificar cada prueba que están
realizando.
Esto les ayudara bastante a la hora de integrar
las apis a su sistema.

4/07/23 Creado por Bancard todos los derechos reservados. 9


Apis del servicio
APIS DEL SERVICIO

Pago Ocasional

Por cada vez que desean realizar un pago


deben ingresar todos los datos de su tarjeta.

Pago Recurrente(con token)

Solo deben catastrar una vez su tarjeta y de


ahí en adelante hacer el pago solo con un
click!

4/07/23 Creado por Bancard todos los derechos reservados. 11


Pago Ocasional

Compra simple
Pago Ocasional

2 - renderiza formulario de pago ocasional


`Bancard.Checkout.createForm`
Commerce Mobile/Web App vPOS Portal

1 - iniciar pedido de pago `single_buy` :process_id

Commerce Backend 3 – POST a “url_confirmation” del comercio


vPOS Server

Llamadas privadas con seguridad


manejando claves públicas y
privadas
4/07/23 Creado por Bancard todos los derechos reservados. 13
Pago Ocasional
Producción https://vpos.infonet.com.py/vpos/api/0.3/single_buy
Staging https://vpos.infonet.com.py:8888/vpos/api/0.3/single_buy
Compra simple
Método petición HTTP POST
md5(private_key + shop_process_id + amount + currency)

Identificador del pedido de compra, asignado por el comercio

Monto en guaraníes con dos decimales

PYG, En Bancard solo procesamos en guaraníes

Campo para
promociones:

El test_client no se debe enviar para que se les marque la lista de test

4/07/23 Creado por Bancard todos los derechos reservados. 14


Pago Ocasional
Retorno del servicio: Si esta todo correcto en el pedido, el servicio retorna success con el
process_id

Si existe algún error en el pedido, el servicio retorna error


con una descripción del error

• Una vez obtenido el process_id, el usuario podrá incluir en su e-commerce un formulario de checkout embebido, de esta forma la
compra se podrá finalizar en su propia aplicación. Para esto podrá utilizar la librería JavaScript como se indica en el siguiente
repositorio de código.
El JavaScript para iframe de pago ocasional se encuentra publicado(recomendamos utilizar el publicado, ya que si sufre mejoras
siempre tendrán la ultima versión actualizada):

Producción
https://vpos.infonet.com.py:8888/checkout/
new?process_id=94y_wb5uUAdU-ow_jp.l
https://vpos.infonet.com.py/checkout/javascript/dist/bancard-checkout-3.0.0.js
Staging Ejemplo de código html para llamar al js
https://vpos.infonet.com.py:8888/checkout/javascript/dist/bancard-checkout-3.0.0.js https://www.w3schools.com/code/tryit.
asp?filename=G8S9S880LRMU
4/07/23 Creado por Bancard todos los derechos reservados. 15
Pago Ocasional

2 - renderiza formulario de pago ocasional


`Bancard.Checkout.createForm`
Commerce Mobile/Web App vPOS Portal

1 - iniciar pedido de pago `single_buy` :process_id

Commerce Backend 3 – POST a “url_confirmation” del comercio


vPOS Server

Llamadas privadas con seguridad


manejando claves públicas y
privadas
4/07/23 Creado por Bancard todos los derechos reservados. 16
window. onload = function () {
Pago Ocasional
Bancard.Checkout.createForm ('iframe-container', process_id ', styles);}

Pueden personalizar el iframe en el


panel del vpos, como también
pueden mandar los campos para
personalizar por medio de código
html

<script type="application/javascript">
styles = {
"form-background-color": "#001b60",
"button-background-color": "#4faed1",
"button-text-color": "#fcfcfc",
"button-border-color": "#dddddd",
"input-background-color": "#fcfcfc",
"input-text-color": "#111111",
"input-placeholder-color": "#111111"
};

4/07/23 Creado por Bancard todos los derechos reservados. 17


Pago Ocasional

4/07/23 Creado por Bancard todos los derechos reservados. 18


Pago Ocasional
Datos de pruebas:

Nombre: MasterCard Nombre: Visa
Número: 5418630110000014 Número: 4907860500000016
Vencimiento: 8/21 Vencimiento: 8/21
Código de seguridad: 258 Código de seguridad: 599

4/07/23 Creado por Bancard todos los derechos reservados. 19


Pago Ocasional

2 - renderiza formulario de pago ocasional


`Bancard.Checkout.createForm`
Commerce Mobile/Web App vPOS Portal

1 - iniciar pedido de pago `single_buy` :process_id

Commerce Backend 3 – POST a “url_confirmation” del comercio


vPOS Server

Llamadas privadas con seguridad


manejando claves públicas y
privadas
4/07/23 Creado por Bancard todos los derechos reservados. 20
Pago Ocasional
Buy Single Confirm:

Bancard realizará una petición POST enviando el JSON en el cuerpo del


pedido o body.

El comercio deberá responder con status 200 a la operación.

Si el comercio no responde con status 200 dentro de los siguientes 60


segundos, vPOS cerrará la conexión y se marcará como inválida la
confirmación en la traza y con una indicación del timeout en reemplazo
de lo que debió ser la respuesta del comercio.

El servicio NO envía una reversa automática en caso que el comercio no responda con status 200. Si la transacción fue una
aprobada, queda como aprobada.
Queda a cargo del comercio regularizar en su sistema, puede regularizar utilizando la api de consulta o de reversa.

4/07/23 Creado por Bancard todos los derechos reservados. 21


Pago Ocasional
Analizando la respuesta (Aprobada)

La respuesta de la transacción se les envía a la url de confirmación que cargaron en el portal de comercios

“S” significa que el proceso termino


correctamente

Siempre debe ser PYG, en Bancard solo procesamos en guaraníes

Cuando venga un código en este campo, significa que la transacción


es aprobada
Nro de ticket, es el identificador global en Bancard, con el cual
podrán consulta/reclamar una transacción.
- 00 (transacción aprobada)
- 05 (Tarjeta inhabilitada)
- 12 (Transacción inválida)
- 15 (Tarjeta inválida)
- 51 (Fondos insuficientes)

Índice de riesgo: vendrá un dato si es tarjeta local

4/07/23 Creado por Bancard todos los derechos reservados. 22


Pago Ocasional
Analizando la respuesta (Denegada)

La respuesta de la transacción se les envía a la url de confirmación que cargaron en el portal de comercios

“S” significa que el proceso termino


correctamente

Siempre debe ser PYG, en Bancard solo procesamos en guaraníes

Cuando venga null, significa que la transacción es denegada


Nro de ticket, es el identificador global en Bancard, con el cual
podrán consulta/reclamar una transacción.
- 00 (transacción aprobada)
- 05 (Tarjeta inhabilitada)
- 12 (Transacción inválida)
- 15 (Tarjeta inválida)
- 51 (Fondos insuficientes)

Índice de riesgo: vendrá un dato si es tarjeta local

4/07/23 Creado por Bancard todos los derechos reservados. 23


Pago Ocasional
Analizando la respuesta (Error)

Si hay algún error con el pedido de pago, el servicio retorna status error con una descripción del error.

4/07/23 Creado por Bancard todos los derechos reservados. 24


Pago Ocasional
Interfaz de respuesta

Luego de que el usuario ingresa sus datos de tarjeta y se confirma al comercio por medio de la operación “Buy Single Confirm”
el comercio debe desplegar una interfaz de respuesta con la aprobación de la transacción.

● Se deben indicar los datos de la transacción: ● No debe mostrarse al usuario:


Fecha y Hora Código de autorización (authorization_number)
Número de pedido (shop_process_id) Código de respuesta (response_code)
Importe (amount) Respuesta extendida (extended_response_description)
Descripción de la Respuesta (response_description) Información de seguridad (security_information)

4/07/23 Creado por Bancard todos los derechos reservados. 25


Pago Ocasional
Score de Riesgo

● El atributo de “risk_index”
Consiste en un índice de riesgo de la transacción en tiempo real, este campo devolverá un número que indicará al comercio el
riesgo de la transacción en tiempo real de acuerdo a la siguiente tabla:

Escala Riesgo El índice de riesgo será generado para las transacciones que se
0 No se puede generar el riesgo en realicen con tarjeta de crédito local.
tiempo real

1 Bajo
Para las transacciones con tarjetas internacionales el campo
risk_index mostrará 0.
2 Bajo

3 Bajo Para las transacciones con tarjetas de débito el campo risk_index


4 Medio mostrará 0.
5 Medio
Para las transacciones con tarjetas de crédito de otra procesadora
6 Medio (cabal, panal) mostrará 0.
7 Alto
El campo risk_index mostrará 0 cuando no se puede generar el
8 Alto
índice de riesgo en tiempo real.
9 Alto

4/07/23 Creado por Bancard todos los derechos reservados. 26


Pago Ocasional
¿Qué tipo de tarjetas se aceptan en el pago ocasional?

Esta operación acepta:


- VISA
- Tarjetas de crédito local. - MASTERCARD
- Tarjetas de crédito internacional. - AMEX
- JCB
- Tarjetas de débito internacional.
- CABAL/PANAL
Esta operación no acepta: - BANCARD
- DINERS
- Tarjeta de débito local. - CREDIFIELCO
- CREDICARD

4/07/23 Creado por Bancard todos los derechos reservados. 27


Zimple
ZIMPLE
Producción https://vpos.infonet.com.py/vpos/api/0.3/single_buy
Staging https://vpos.infonet.com.py:8888/vpos/api/0.3/single_buy

Método petición HTTP POST


md5(private_key + shop_process_id + amount + currency)

Identificador del pedido de compra, asignado por el comercio

Monto en guaraníes con dos decimales

PYG, En Bancard solo procesamos en guaraníes

Campo donde se debe


enviar el nro de teléfono de
la billetera zimple

Para pruebas:
"additional_data": "0981123456"
El campo zimple donde indican que están queriendo realizar el pago por medio de zimple

4/07/23 Creado por Bancard todos los derechos reservados. 29


ZIMPLE
Retorno del servicio: Si esta todo correcto en el pedido, el servicio retorna success con el
process_id

Si existe algún error en el pedido, el servicio retorna error


con una descripción del error

• Una vez obtenido el process_id, el usuario podrá incluir en su e-commerce un formulario de zimple embebido, de esta forma la
compra se podrá finalizar en su propia aplicación. Para esto podrá utilizar la librería JavaScript como se indica en el siguiente
repositorio de código.
El JavaScript para iframe de zimple se encuentra publicado(recomendamos utilizar el publicado, ya que si sufre mejoras siempre
tendrán la ultima versión actualizada):

Producción
https://vpos.infonet.com.py/checkout/javascript/dist/bancard-checkout-3.0.0.js Ejemplo de código html para llamar al js
Staging
https://www.w3schools.com/code/tryit.as
https://vpos.infonet.com.py:8888/checkout/javascript/dist/bancard-checkout-3.0.0.js p?filename=G8SA9F0IQIDC

4/07/23 Creado por Bancard todos los derechos reservados. 30


window. onload = function () {
ZIMPLE
Bancard.Zimple.createForm ('iframe-container', process_id ', styles);}

Pueden personalizar el iframe en el


panel del vpos, como también
pueden mandar los campos para
personalizar por medio de código
html

<script type="application/javascript">
styles = {
"form-background-color": "#001b60",
"button-background-color": "#4faed1",
"button-text-color": "#fcfcfc",
"button-border-color": "#dddddd",
"input-background-color": "#fcfcfc",
"input-text-color": "#111111",
"input-placeholder-color": "#111111"
};

4/07/23 Creado por Bancard todos los derechos reservados. 31


ZIMPLE

Flujo para pago con Zimple


• Enviar el pedido de single_buy con las variantes para
Zimple.
• El servicio enviará un código al teléfono cargado en el
campo additional_data.
• Levantar el iframe Zimple.
• El usuario debe cargar el código que llego a su teléfono en
el iframe.
• Al confirmar el pago se debitará de su billetera Zimple.

Luego de que el usuario ingrese el OTP y le da al botón de


PAGAR, entonces el vpos realiza un POST a la url de
confirmación que el comercio proporciono en el panel de la
aplicación.

Obs: El código OTP para las pruebas es 1234 para una


transaccion aprobada.
4/07/23 Creado por Bancard todos los derechos reservados. 32
ZIMPLE
Buy Single Confirm:

Bancard realizará una petición POST enviando el JSON en el cuerpo del


pedido o body.

El comercio deberá responder con status 200 a la operación.

Si el comercio no responde con status 200 dentro de los siguientes 60


segundos, vPOS cerrará la conexión y se marcará como inválida la
confirmación en la traza y con una indicación del timeout en reemplazo
de lo que debió ser la respuesta del comercio.

El servicio NO envía una reversa automática en caso que el comercio no responda con status 200. Si la transacción fue una
aprobada, queda como aprobada.
Queda a cargo del comercio regularizar en su sistema, puede regularizar utilizando la api de consulta o de reversa.

4/07/23 Creado por Bancard todos los derechos reservados. 33


ZIMPLE
Analizando la respuesta (Aprobada)

La respuesta de la transacción se les envía a la url de confirmación que cargaron en el portal de comercios

“S” significa que el proceso termino


correctamente

Cuando venga un código en este campo, significa que la transacción


es aprobada

Nro de ticket, es el identificador global en Bancard, con el cual


podrán consulta/reclamar una transacción.

- 00 (transacción aprobada)
- 05 (Tarjeta inhabilitada)
- 12 (Transacción inválida)
- 15 (Tarjeta inválida)
- 51 (Fondos insuficientes)

4/07/23 Creado por Bancard todos los derechos reservados. 34


Pago con Token

Catastro tarjeta Listar tarjetas Eliminar tarjeta Pago con token


Pago con Token
¿Qué tipo de tarjetas se aceptan en el pago con token?

Tarjetas que aplican para el catastro

Esta operación acepta:


- Tarjetas de crédito local.
- Tarjeta de débito local.

Esta operación NO acepta:


- Tarjetas de crédito internacional.
- Tarjetas de débito internacional.

4/07/23 Creado por Bancard todos los derechos reservados. 36


Pago con Token

2 - renderiza formulario de catastro


`Bancard.Cards.createForm`
Commerce Mobile/Web App vPOS Portal

1 - iniciar catastro `cards/new` :process_id


3 - recuperar tarjetas `users/:user_id/cards`
Commerce Backend vPOS Server
5 - Pago `charge`

4 - • selección de tarjeta por el usuario


• proceso de selección por defecto
Llamadas privadas con seguridad
manejando claves públicas y
privadas
4/07/23 Creado por Bancard todos los derechos reservados. 37
Pago con Token
Producción https://vpos.infonet.com.py/vpos/api/0.3/cards/new
Staging https://vpos.infonet.com.py:8888/vpos/api/0.3/cards/new
Catastro tarjeta
Método petición HTTP POST md5(private_key + card_id + user_id + "request_new_card”)

Card_id y user_id: ambos campos son proporcionados por el


comercio para identificar su usuario y su tarjeta.
Un user_id puede tener varios card_id.
Un user_id no se puede repetir.
El card_id es único por user_id.

Campo teléfono y mail son obligatorios por si existe algún


inconveniente con el catastro de su tarjeta

El test_client no se debe enviar para que se les marque la lista de test

4/07/23 Creado por Bancard todos los derechos reservados. 38


Pago con Token
Retorno del servicio: Si esta todo correcto en el pedido, el servicio retorna success con el
process_id

Si existe algún error en el pedido, el servicio retorna error


con una descripción del error

• Una vez obtenido el process_id, el usuario podrá incluir en su e-commerce un formulario de checkout embebido, de esta
forma la compra se podrá finalizar en su propia aplicación. Para esto podrá utilizar la librería JavaScript como se indica en
el siguiente repositorio de código.
El JavaScript para iframe de catastro se encuentra publicado:

Producción
Ejemplo de código html para llamar al js
https://vpos.infonet.com.py/checkout/javascript/dist/bancard-checkout-3.0.0.js
Staging https://www.w3schools.com/code/
https://vpos.infonet.com.py:8888/checkout/javascript/dist/bancard-checkout-3.0.0.js tryit.asp?filename=G8S05JBF02N1

4/07/23 Creado por Bancard todos los derechos reservados. 39


Pago con Token

2 - renderiza formulario de catastro


`Bancard.Cards.createForm`
Commerce Mobile/Web App vPOS Portal

1 - iniciar catastro `cards/new` :process_id

3 - recuperar tarjetas `users/:user_id/cards`


Commerce Backend vPOS Server
5 - Pago `charge`

4 - • selección de tarjeta por el usuario


• proceso de selección por defecto
Llamadas privadas con seguridad
manejando claves públicas y
privadas
4/07/23 Creado por Bancard todos los derechos reservados. 40
Pago con Token
window. onload = function () {

Bancard.Cards. createForm ('iframe-container', process_id ', styles);}

4/07/23 Creado por Bancard todos los derechos reservados. 41


Pago con Token

Se carga los datos de la tarjeta

Se carga la cedula dueña de la tarjeta

4/07/23 Creado por Bancard todos los derechos reservados. 42


Pago con Token
Luego de insertar la cedula, lo que el servicio realiza es una validación de los datos, la tarjeta debe pertenecer a la cedula que se
ingreso. Si la validación es correcta, entonces saldrán unas preguntas de seguridad.

Las preguntas de seguridad se genera por un motor que desarrolló Bancard el cual lo llamamos TU ERES TU.
TU ERES TU es un motor inteligente de KYC (Know your costumer), permite obtener preguntas de diferentes fuentes para validar a
la persona y así asegurarse de que no existan riesgos si una tarjeta es robada o de que se roben datos de algún usuario.
Este mecanismo de seguridad se implementa para proteger al usuario, dueño de la tarjeta, asegurándonos de que la persona que
está catastrando la tarjeta es la dueña de la tarjeta.

4/07/23 Creado por Bancard todos los derechos reservados. 43


Pago con Token
La cantidad de preguntas que le salgan al usuario es una configuración que realiza Bancard en el motor de TU ERES TU. Una vez que TU
ERES TU valida que la persona efectivamente es dueña de la tarjeta. Si ha respondido correctamente todas las preguntas el servicio
responderá con success!

Si la validación no es correcta el catastro se inhabilita. Le aparece un mensaje para que se comunique con el CAC de Bancard, donde el
CAC le hará unas preguntas de seguridad, donde si se valida la veracidad del dueño entonces se habilita el catastro de la tarjeta.

Luego de tener el success de la aplicación, ya tienen una tarjeta catastrada para ese user_id y esa tarjeta tiene un card_id que son los
datos que les servirán para obtener un token.

Cada vez que un usuario quiera pagar con token, lo que se debe realizar es llamar a la api para listar las tarjetas, esa api les lista todas las
tarjetas catastradas para ese user_id con un alias_token para cada tarjeta, donde uds muestran esos datos en la vista y entonces el
usuario podrá elegir entre todas sus tarjetas catastradas y realizar un pago con un click.

4/07/23 Creado por Bancard todos los derechos reservados. 44


Pago con Token

2 - renderiza formulario de catastro


`Bancard.Cards.createForm`
Commerce Mobile/Web App vPOS Portal

1 - iniciar catastro `cards/new` :process_id

Commerce Backend 3 - recuperar tarjetas `users/:user_id/cards`


vPOS Server
5 - Pago `charge`

4 - • selección de tarjeta por el usuario


• proceso de selección por defecto
Llamadas privadas con seguridad
manejando claves públicas y
privadas
4/07/23 Creado por Bancard todos los derechos reservados. 46
Pago con Token
Producción https://vpos.infonet.com.py/vpos/api/0.3/users/user_id/cards
Staging https://vpos.infonet.com.py:8888/vpos/api/0.3/ users/user_id/cards
Listar tarjetas

Método petición HTTP POST


En el llamado a la api se envía el user_id

md5(private_key + user_id +
"request_user_cards”)

El test_client no se debe enviar para que se les marque la lista de test

4/07/23 Creado por Bancard todos los derechos reservados. 47


Pago con Token

Si esta todo correcto en el pedido, el


servicio retorna success con un array cards
donde se listaran las N tarjetas catastradas
por ese user_id.

El Alias_token que retorna es temporal,


sirve para un pago y el tiempo de vida es de
60 minutos.

Si existe algún error en el pedido, el servicio


retorna error con una descripción del error.

4/07/23 Creado por Bancard todos los derechos reservados. 48


Pago con Token

2 - renderiza formulario de catastro


`Bancard.Cards.createForm`
Commerce Mobile/Web App vPOS Portal

1 - iniciar catastro `cards/new` :process_id

Commerce Backend 3 - recuperar tarjetas `users/:user_id/cards`


vPOS Server
5 - Pago `charge`

4 -•selección de tarjeta por el


usuario
Llamadas privadas con seguridad
•proceso de selección por manejando claves públicas y
defecto privadas
4/07/23 Creado por Bancard todos los derechos reservados. 49
Pago con Token
Producción https://vpos.infonet.com.py/vpos/api/0.3/charge
Staging https://vpos.infonet.com.py:8888/vpos/api/0.3/ charge
Pago con token

Método petición HTTP POST


md5(private_key + shop_process_id + "charge" + amount + currency + alias_token)

Shop process id es un identificador único del pedido de compra

Cantidad de pagos: Esto es en cuantas cuotas, la financiación es con la entidad del usuario

Alias token generado con la api para obtener tarjetas

El test_client no se debe enviar para que se les marque la lista de test

4/07/23 Creado por Bancard todos los derechos reservados. 50


Pago con Token
Analizando la respuesta (Aprobada)

“S” significa que el proceso termino


correctamente

Siempre debe ser PYG, en Bancard solo procesamos en guaraníes

Cuando venga un código en este campo, significa que la transacción


es aprobada

- 00 (transacción aprobada)
- 05 (Tarjeta inhabilitada)
- 12 (Transacción inválida)
- 15 (Tarjeta inválida)
- 51 (Fondos insuficientes)

Índice de riesgo: vendrá un dato si es tarjeta local

4/07/23 Creado por Bancard todos los derechos reservados. 51


Pago con Token
Analizando la respuesta (Denegada)

“S” significa que el proceso termino


correctamente

Siempre debe ser PYG, en Bancard solo procesamos en guaraníes

Cuando venga null, significa que la transacción es denegada

- 00 (transacción aprobada)
- 05 (Tarjeta inhabilitada)
- 12 (Transacción inválida)
- 15 (Tarjeta inválida)
- 51 (Fondos insuficientes)

Índice de riesgo: vendrá un dato si es tarjeta local

4/07/23 Creado por Bancard todos los derechos reservados. 52


Pago con Token
Analizando la respuesta (Error)

Si hay algún error con el pedido de pago, el servicio retorna status error con una descripción del error.

4/07/23 Creado por Bancard todos los derechos reservados. 53


Pago con Token
Interfaz de respuesta

Luego de que el usuario ingresa sus datos de tarjeta y se confirma al comercio, el comercio debe desplegar una interfaz de
respuesta con la aprobación de la transacción.

● Se deben indicar los datos de la transacción: ● No debe mostrarse al usuario:


Fecha y Hora Código de autorización (authorization_number)
Número de pedido (shop_process_id) Código de respuesta (response_code)
Importe (amount) Respuesta extendida (extended_response_description)
Descripción de la Respuesta (response_description) Información de seguridad (security_information)

4/07/23 Creado por Bancard todos los derechos reservados. 54


Pago con Token
Producción https://vpos.infonet.com.py/vpos/api/0.3/users/user_id/cards
Staging https://vpos.infonet.com.py:8888/vpos/api/0.3/ users/user_id/cards
Eliminar tarjeta

Método petición HTTP DELETE


En el llamado a la api se envía el user_id

md5(private_key + "delete_card" + user_id + card_token)

Alias token generado con la api para obtener tarjetas

El test_client no se debe enviar para que se les marque la lista de test

4/07/23 Creado por Bancard todos los derechos reservados. 55


Pago con Token

Si esta todo correcto en el pedido, el servicio


retorna success con un array cards donde se
listaran las N tarjetas catastradas por ese
user_id

El Alias_token que retorna es temporal, sirve


para un pago y el tiempo de vida es de 30
minutos

Si existe algún error en el pedido, el


servicio retorna error con una
descripción del error

4/07/23 Creado por Bancard todos los derechos reservados. 56


Pago con Token(Multibuy)

Catastro tarjeta Listar tarjetas Eliminar tarjeta Pago con token


Pago con Token(Multibuy)

Pago con token (Multibuy)

Varios códigos de comercio


Cuenta
Código Electrotienda
Marketplace
Cuenta
MiRopa

Cuenta
Mueblería AB

Código Código Código


Electrotienda MiRopa Mueblería AB

4/07/23 Creado por Bancard todos los derechos reservados. 58


Pago con Token
Producción https://vpos.infonet.com.py/vpos/api/0.3/multi/charge
Staging https://vpos.infonet.com.py:8888/vpos/api/0.3/multi/ charge
Pago con token

Método petición HTTP POST


md5(private_key + shop_process_id + "charge" + total_amount + number_items)

Shop process id es un identificador único del pedido de compra

Cada ítem tiene el código/sucursal del comercio asociado.

Alias token generado con la api para obtener tarjetas

El test_client no se debe enviar para que se les marque la lista de test


4/07/23 Creado por Bancard todos los derechos reservados. 59
Operación comunes

Rollback compra Consultar compra


Operaciones comunes
Producción https://vpos.infonet.com.py/vpos/api/0.3/ single_buy/rollback
Staging https://vpos.infonet.com.py:8888/vpos/api/0.3 single_buy/rollback
Rollback compra

Método petición HTTP POST

md5(private_key + shop_process_id + "rollback" + "0.00”)

Shop process id del pedido de compra que desean reversar

El test_client no se debe enviar para que se les marque la lista de test

El rollback es un proceso que de sebe realizar transaccionalmente, NO es un proceso operativo. Solo debe usarse si es que ocurre algún
inconveniente de comunicación entre el comercio y el servicio.
Para un proceso operativo, solicitar el rollback por el canal del CAC de Bancard.

4/07/23 Creado por Bancard todos los derechos reservados. 61


Operaciones comunes
Si esta todo correcto en el pedido, el servicio
retorna success.

Si existe algún error en el pedido, el


servicio retorna error con una
descripción del error.

4/07/23 Creado por Bancard todos los derechos reservados. 62


Operaciones comunes
Producción https://vpos.infonet.com.py/vpos/api/0.3/ single_buy/ confirmations
Staging https://vpos.infonet.com.py:8888/vpos/api/0.3 single_buy/ confirmations
Consultar compra

Método petición HTTP POST

md5(private_key + shop_process_id + "get_confirmation”)

Shop process id del pedido de compra que desean consultar

El test_client no se debe enviar para que se les marque la lista de test

4/07/23 Creado por Bancard todos los derechos reservados. 63


Operaciones comunes

Si esta todo correcto en el pedido, el servicio


retorna success. Con todo el detalle de la
transacción (es la misma información que se
retorna cuando se realiza un pago aprobado)

Si existe algún error en el pedido, el


servicio retorna error con una
descripción del error.

4/07/23 Creado por Bancard todos los derechos reservados. 64


Paso a
producción

65
Paso a PRODUCCIÓN
Una vez que hayan realizado integrado todas las operaciones exitosamente, se habilitara el botón para solicitar la certificación.

url a certificar: Generalmente el comercio nos


provee una url de su ambiente de pruebas, si
es necesario un usuario y contraseña también
no lo proveen.

El pedido de certificación llega a nuestro equipo de soporte donde verifican la integración que realizaron. Verifican el sitio
ecommerce, realizan unas compras de prueba, si la verificación esta correcta entonces se les habilita la pestaña de producción.
4/07/23 Creado por Bancard todos los derechos reservados. 66
Paso a PRODUCCIÓN

En la pestaña producción tienen claves


nuevas y también un perfil que completar.
Una vez que configuren todo y apunten a
producción con las claves nuevas ya podrán
operar en producción sin inconvenientes.

4/07/23 Creado por Bancard todos los derechos reservados. 67


Paso a PRODUCCIÓN
Canal de soporte del servicio
El servicio cuenta con un canal de soporte oficial desde el portal de comercios, donde se tiene especificado el ambiente en que
quieren realizar la consulta o reportar algún incidente.

- Incidentes en producción: Tiene


una cobertura 24/7.
- Incidentes en prueba de
integración: Tiene una cobertura
en horario de oficina. Lunes a
Viernes de 08:00 a 17:00hs.

4/07/23 Creado por Bancard todos los derechos reservados. 68


Gracias

4/07/23 Creado por Bancard todos los derechos reservados. 69

También podría gustarte