Skip to main content

Integración

Contrato​

Contactar a ventas.conexiones@modo.com.ar con asunto "Pedido de contrato para VaTa".
El mismo debe ser completado y reenviado al mail mencionado.

Requisitos​

Para utilizar el servicio se requieren credenciales client_id y client_secret las cuales serán enviadas via e-mail luego del alta como cliente.
A su vez el servicio cuenta con protección mTLS por lo que es necesario enviar un CSR (Certificate Signing Request) a devsecops@modo.com.ar con los siguientes valores:

Producción

CN=mtls.api.modo.com.ar, OU=MODO Conexiones - Production, O=<Nombre del cliente>, L=Ciudad Autonoma de Buenos Aires, S=Ciudad Autonoma de Buenos Aires, C=AR

Staging

CN=mtls.staging.api.modo.com.ar, OU=MODO Conexiones - Staging, O=<Nombre del cliente>, L=Ciudad Autonoma de Buenos Aires, S=Ciudad Autonoma de Buenos Aires, C=AR

Una vez recibido se les enviará el certificado (.crt) y la clave (.key)

Entorno de prueba​

Las pruebas del servicio se realizan en el entorno staging en el cual se puede validar que la conexión funciona correctamente utilizando peticiones de ejemplo.
En este entorno no es posible utilizar tarjetas reales, solo se podran utilizar los siguientes datos:

Tarjeta válida (200)

curl --location 'https://mtls.staging.api.modo.com.ar/connections/cards/validate' \
--header 'client_id: <client-id>' \
--header 'client_secret: <client-secret>' \
--header 'Content-Type: application/json' \
--data '{
  "dni": "34534512",
  "gender": "M",
  "card": {
    "expiry": "03/26",
    "last_digits": "1234",
    "bin": "123456",
    "type": "DEBIT",
    "issuer_name": "visa"
  }
}'

Tarjeta inválida (409)

curl --location 'https://mtls.staging.api.modo.com.ar/connections/cards/validate' \
--header 'client_id: <client-id>' \
--header 'client_secret: <client-secret>' \
--header 'Content-Type: application/json' \
--data '{
  "dni": "34534513",
  "gender": "M",
  "card": {
    "expiry": "03/26",
    "last_digits": "1234",
    "bin": "123459",
    "type": "DEBIT",
    "issuer_name": "visa"
  }
}'

Emisor no encontrado 404

curl --location 'https://mtls.staging.api.modo.com.ar/connections/cards/validate' \
--header 'client_id: <client-id>' \
--header 'client_secret: <client-secret>' \
--header 'Content-Type: application/json' \
--data '{
  "dni": "34534512",
  "gender": "M",
  "card": {
    "expiry": "03/26",
    "last_digits": "1234",
    "bin": "111111",
    "type": "DEBIT",
    "issuer_name": "visa"
  }
}'

Prueba masiva​

Con el fin de determinar la viabilidad del servicio previa contratación ofrecemos la posibilidad de realizar por única vez una validación de hasta 2000 tarjetas reales.
Para ello se debe enviar un mail a ventas.conexiones@modo.com.ar con asunto "Prueba masiva nombre-de-cliente" adjuntando un archivo .csv con el siguiente formato:

dni,gender,expiry,last_digits,type,bin,issuer_name

Para más detalles sobre los campos consultar la documentación de la API.

Una vez recibido lo procesaremos y enviaremos como respuesta al mail un nuevo archivo .csv con los resultados.