NAV Navbar
Genérico Bash Python Node.js
  • Introducción
  • Condiciones Generales
  • Datos de prueba
  • Login
  • Listar Clientes
  • Seleccionar cliente
  • Listar cuentas
  • Listar movimientos
  • Preprocesar Transferencia
  • Confirmar Transferencia
  • Listar Instituciones para Transferencias
  • Listar Proveedores
  • Detalle de Proveedor
  • Introducción

    
          ___           ___           ___           ___           ___           ___           ___           ___
         /\  \         /\  \         /\  \         /\__\         /\  \         /\  \         /\  \         /\  \
        /::\  \       /::\  \       /::\  \       /::|  |       /::\  \        \:\  \       /::\  \       /::\  \
       /:/\:\  \     /:/\:\  \     /:/\:\  \     /:|:|  |      /:/\:\  \        \:\  \     /:/\:\  \     /:/\:\  \
      /::\~\:\  \   /::\~\:\  \   /:/  \:\  \   /:/|:|__|__   /::\~\:\  \       /::\  \   /::\~\:\  \   /:/  \:\  \
     /:/\:\ \:\__\ /:/\:\ \:\__\ /:/__/ \:\__\ /:/ |::::\__\ /:/\:\ \:\__\     /:/\:\__\ /:/\:\ \:\__\ /:/__/ \:\__\
     \/__\:\/:/  / \/_|::\/:/  / \:\  \ /:/  / \/__/~~/:/  / \:\~\:\ \/__/    /:/  \/__/ \:\~\:\ \/__/ \:\  \ /:/  /
          \::/  /     |:|::/  /   \:\  /:/  /        /:/  /   \:\ \:\__\     /:/  /       \:\ \:\__\    \:\  /:/  /
           \/__/      |:|\/__/     \:\/:/  /        /:/  /     \:\ \/__/     \/__/         \:\ \/__/     \:\/:/  /
                      |:|  |        \::/  /        /:/  /       \:\__\                      \:\__\        \::/  /
                       \|__|         \/__/         \/__/         \/__/                       \/__/         \/__/
    
    
    echo "
          ___         ___           ___           ___           ___                         ___           ___
         /\  \       /\  \         /\  \         /\  \         /\__\                       /\__\         /\  \
        /::\  \     /::\  \       /::\  \       |::\  \       /:/ _/_         ___         /:/ _/_       /::\  \
       /:/\:\__\   /:/\:\__\     /:/\:\  \      |:|:\  \     /:/ /\__\       /\__\       /:/ /\__\     /:/\:\  \
      /:/ /:/  /  /:/ /:/  /    /:/  \:\  \   __|:|\:\  \   /:/ /:/ _/_     /:/  /      /:/ /:/ _/_   /:/  \:\  \
     /:/_/:/  /  /:/_/:/__/___ /:/__/ \:\__\ /::::|_\:\__\ /:/_/:/ /\__\   /:/__/      /:/_/:/ /\__\ /:/__/ \:\__\
     \:\/:/  /   \:\/:::::/  / \:\  \ /:/  / \:\~~\  \/__/ \:\/:/ /:/  /  /::\  \      \:\/:/ /:/  / \:\  \ /:/  /
      \::/__/     \::/~~/~~~~   \:\  /:/  /   \:\  \        \::/_/:/  /  /:/\:\  \      \::/_/:/  /   \:\  /:/  /
       \:\  \      \:\~~\        \:\/:/  /     \:\  \        \:\/:/  /   \/__\:\  \      \:\/:/  /     \:\/:/  /
        \:\__\      \:\__\        \::/  /       \:\__\        \::/  /         \:\__\      \::/  /       \::/  /
         \/__/       \/__/         \/__/         \/__/         \/__/           \/__/       \/__/         \/__/    "
    

    ¡Bienvenido a la documentación de la API de Prometeo! Prometeo es una plataforma de APIs estandarizada creada por Qualia Fintech Factory. A continuación accederás a la documentación de la plataforma. Podrás usar esta documentación para acceder a los endpoints, donde podrás encontrar información sobre cómo acceder a bancos, cuentas bancarias y movimientos.

    Si el lenguaje en el que estas desarrollando no está listando en los ejemplos, no dudes en contactarnos.

    Condiciones Generales

    Para solicitar acceso al ambiente de pruebas, por favor escríbenos a info@qualia.uy.

    Datos de prueba

    Login

    Endpoint: POST /login/

    Endpoint: https://test.prometeo.qualia.uy/login/
    Método: POST
    parámetro: provider=test&username=12345&password=asdfg
    
    # Con bash, hay que especificar la autenticación en cada request:
    

    Usuario 1

    POST /login/? HTTP/1.1
    Host: test.prometeo.qualia.uy
    Accept: application/json
    X-API-Key: <api key>
    
    provider=test&username=12345&password=asdfg
    
    curl -X POST "https://test.prometeo.qualia.uy/login/?" -d 'provider=test&username=12345&password=asdfg' -H "X-API-Key: <api key>"
    
    import requests
    
    requests.post('https://test.prometeo.qualia.uy/login/', headers={'X-API-Key': '<api key>'}, data={
      "provider": "test",
      "username": "12345",
      "password": "asdfg"
    })
    
    var request = require('request');
    
    request.post({
      "url": "https://test.prometeo.qualia.uy/login/",
      "json": true,
      "headers": {
        "X-API-Key": "<api key>"
      },
      "form": {
        "provider": "test",
        "username": "12345",
        "password": "asdfg"
      }
    });
    

    Usuario 2

    POST /login/? HTTP/1.1
    Host: test.prometeo.qualia.uy
    Accept: application/json
    X-API-Key: <api key>
    
    provider=test&username=12345&password=gfdsa
    
    curl -X POST "https://test.prometeo.qualia.uy/login/?" -d 'provider=test&username=12345&password=gfdsa' -H "X-API-Key: <api key>"
    
    import requests
    
    requests.post('https://test.prometeo.qualia.uy/login/', headers={'X-API-Key': '<api key>'}, data={
      "provider": "test",
      "username": "12345",
      "password": "gfdsa"
    })
    
    var request = require('request');
    
    request.post({
      "url": "https://test.prometeo.qualia.uy/login/",
      "json": true,
      "headers": {
        "X-API-Key": "<api key>"
      },
      "form": {
        "provider": "test",
        "username": "12345",
        "password": "gfdsa"
      }
    });
    

    Respuesta Usuario 1

    {
       "status" : "select_client",
       "key" : "959602df-d3ee-4898-b6d8-a28a2c7486fb"
    }
    

    Respuesta Usuario 2

    {
       "status" : "logged_in"
       "key" : "163d06b2-3378-4383-9868-71c2b6fb28da",
    }
    

    Respuesta con interaccion requerida

    {
        "context": "¿Cuántos baños tenia la casa de mis padres?",
        "field": "personal_question",
        "key": "be612b0a-c972-4fb1-bb16-798956a3efa1",
        "status": "interaction_required"
    }
    

    Iniciar sesion con interaccion

    POST /login/? HTTP/1.1
    Host: test.prometeo.qualia.uy
    Accept: application/json
    X-API-Key: <api key>
    
    provider=test&username=12345&password=asdfg&personal_question=uno
    
    curl -X POST "https://test.prometeo.qualia.uy/login/?" -d 'provider=test&username=12345&password=asdfg&personal_question=uno' -H "X-API-Key: <api key>"
    
    import requests
    
    requests.post('https://test.prometeo.qualia.uy/login/', headers={'X-API-Key': '<api key>'}, data={
      "provider": "test",
      "username": "12345",
      "password": "asdfg",
      "personal_question": "uno"
    })
    
    var request = require('request');
    
    request.post({
      "url": "https://test.prometeo.qualia.uy/login/",
      "json": true,
      "headers": {
        "X-API-Key": "<api key>"
      },
      "form": {
        "provider": "test",
        "username": "12345",
        "password": "asdfg",
        "personal_question": "uno"
      }
    });
    

    Respuesta Erronea Usuario 1 y 2

    {"status": "wrong_credentials"}
    

    Parámetros

    Respuesta

    Probar en el Sandbox

    Listar Clientes

    Endpoint: GET /client/

    GET /client/?key=959602df-d3ee-4898-b6d8-a28a2c7486fb HTTP/1.1
    Host: test.prometeo.qualia.uy
    Accept: application/json
    X-API-Key: <api key>
    
    
    
    curl -X GET "https://test.prometeo.qualia.uy/client/?key=959602df-d3ee-4898-b6d8-a28a2c7486fb"  -H "X-API-Key: <api key>"
    
    import requests
    
    requests.get('https://test.prometeo.qualia.uy/client/', headers={'X-API-Key': '<api key>'}, params={
      "key": "959602df-d3ee-4898-b6d8-a28a2c7486fb"
    })
    
    var request = require('request');
    
    request.get({
      "url": "https://test.prometeo.qualia.uy/client/",
      "json": true,
      "headers": {
        "X-API-Key": "<api key>"
      },
      "qs": {
        "key": "959602df-d3ee-4898-b6d8-a28a2c7486fb"
      }
    });
    

    Usuario1

    {  
       "status":"success",
       "clients":{  
          "0":"First Client",
          "1":"Second Client"
       }
    }
    

    Usuarios 2

    {"status": "success", "clients": {}}
    

    Parámetro:

    Respuesta:

    Probar en el Sandbox

    Seleccionar cliente

    Endpoint: GET /client/<id>/

    GET /client/20727/?key=959602df-d3ee-4898-b6d8-a28a2c7486fb HTTP/1.1
    Host: test.prometeo.qualia.uy
    Accept: application/json
    X-API-Key: <api key>
    
    
    
    curl -X GET "https://test.prometeo.qualia.uy/client/20727/?key=959602df-d3ee-4898-b6d8-a28a2c7486fb"  -H "X-API-Key: <api key>"
    
    import requests
    
    requests.get('https://test.prometeo.qualia.uy/client/20727/', headers={'X-API-Key': '<api key>'}, params={
      "key": "959602df-d3ee-4898-b6d8-a28a2c7486fb"
    })
    
    var request = require('request');
    
    request.get({
      "url": "https://test.prometeo.qualia.uy/client/20727/",
      "json": true,
      "headers": {
        "X-API-Key": "<api key>"
      },
      "qs": {
        "key": "959602df-d3ee-4898-b6d8-a28a2c7486fb"
      }
    });
    

    Respuesta Exitosa

    {
       "status" : "success"
    }
    

    Parámetro:

    Respuesta

    Probar en el Sandbox

    Listar cuentas

    Endpoint: GET /account/

    GET /account/?key=959602df-d3ee-4898-b6d8-a28a2c7486fb HTTP/1.1
    Host: test.prometeo.qualia.uy
    Accept: application/json
    X-API-Key: <api key>
    
    
    
    curl -X GET "https://test.prometeo.qualia.uy/account/?key=959602df-d3ee-4898-b6d8-a28a2c7486fb"  -H "X-API-Key: <api key>"
    
    import requests
    
    requests.get('https://test.prometeo.qualia.uy/account/', headers={'X-API-Key': '<api key>'}, params={
      "key": "959602df-d3ee-4898-b6d8-a28a2c7486fb"
    })
    
    var request = require('request');
    
    request.get({
      "url": "https://test.prometeo.qualia.uy/account/",
      "json": true,
      "headers": {
        "X-API-Key": "<api key>"
      },
      "qs": {
        "key": "959602df-d3ee-4898-b6d8-a28a2c7486fb"
      }
    });
    

    Respuesta

    {
       "accounts":  [
              {
          "balance": 1234.95,
          "branch": "02 - 18 De Julio",
          "currency": "UYU",
          "id": "hash1",
          "name": "Cuenta total",
          "number": "001234567890"
        },
              {
          "balance": 12.01,
          "branch": "02 - 18 De Julio",
          "currency": "USD",
          "id": “hash2,
          "name": "Cuenta total",
          "number": "005234567890"
        },
              {
          "balance": 4301,
          "branch": "61 - Ciudad Vieja",
          "currency": "UYU",
          "id": "hash3",
          "name": "Caja De Ahorro Atm",
          "number": "007234567890"
        },
              {
          "balance": 53.96,
          "branch": "61 - Ciudad Vieja",
          "currency": "USD",
          "id": "hash4",
          "name": "Caja De Ahorro Atm",
          "number": "007234567890"
        }
       ],
       "status": "success"
    }
    

    Parámetro:

    Respuesta:

    Probar en el Sandbox

    Listar movimientos

    Endpoint: GET /movement/

    GET /movement/?key=959602df-d3ee-4898-b6d8-a28a2c7486fb&account=12345&currency=UYU&date_start=22%2F11%2F2017&date_end=23%2F11%2F2017 HTTP/1.1
    Host: test.prometeo.qualia.uy
    Accept: application/json
    X-API-Key: <api key>
    
    
    
    curl -X GET "https://test.prometeo.qualia.uy/movement/?key=959602df-d3ee-4898-b6d8-a28a2c7486fb&account=12345&currency=UYU&date_start=22%2F11%2F2017&date_end=23%2F11%2F2017"  -H "X-API-Key: <api key>"
    
    import requests
    
    requests.get('https://test.prometeo.qualia.uy/movement/', headers={'X-API-Key': '<api key>'}, params={
      "key": "959602df-d3ee-4898-b6d8-a28a2c7486fb",
      "account": "12345",
      "currency": "UYU",
      "date_start": "22/11/2017",
      "date_end": "23/11/2017"
    })
    
    var request = require('request');
    
    request.get({
      "url": "https://test.prometeo.qualia.uy/movement/",
      "json": true,
      "headers": {
        "X-API-Key": "<api key>"
      },
      "qs": {
        "key": "959602df-d3ee-4898-b6d8-a28a2c7486fb",
        "account": "12345",
        "currency": "UYU",
        "date_start": "22/11/2017",
        "date_end": "23/11/2017"
      }
    });
    

    Respuesta

    {
       "final_balance": "undefined",
       "initial_balance": "undefined",
       "movements": [
              {
          "credit": "",
          "date": "12/01/2017",
          "debit": 3500,
          "detail": "RETIRO EFECTIVO CAJERO AUTOMATICO J.C. GOMEZ 1372, MONTEVIDEO TARJ: 4303090202018993",
          "id": -890185180,
          "reference": "000000005084"
        },
              {
          "credit": "",
          "date": "05/01/2017",
          "debit": 16000,
          "detail": "RETIRO EFECTIVO CAJERO AUTOMATICO J.H Y OBES 1389, MONTEVIDEO TARJ: 4303090202018993",
          "id": 1024917397,
          "reference": "000000002931"
        },
              {
          "credit": 98640,
          "date": "03/01/2017",
          "debit": "",
          "detail": "SUELDOS 123456TT RECIBIDA /Qualia Fintech S.R.L",
          "id": 1303899175,
          "reference": "TR0003858408"
        }
       ],
       "status": "success"
    }
    

    Parámetro:

    Respuesta:

    Probar en el Sandbox

    Preprocesar Transferencia

    Endpoint: POST /transfer/preprocess

    POST /transfer/preprocess?key=959602df-d3ee-4898-b6d8-a28a2c7486fb HTTP/1.1
    Host: test.prometeo.qualia.uy
    Accept: application/json
    X-API-Key: <api key>
    
    origin_account=002206345988&destination_institution=0&destination_account=001002363321&currency=UYU&amount=1.3&concept=descripcion+de+transferencia&destination_owner_name=John+Doe&branch=62
    
    curl -X POST "https://test.prometeo.qualia.uy/transfer/preprocess?key=959602df-d3ee-4898-b6d8-a28a2c7486fb" -d 'origin_account=002206345988&destination_institution=0&destination_account=001002363321&currency=UYU&amount=1.3&concept=descripcion+de+transferencia&destination_owner_name=John+Doe&branch=62' -H "X-API-Key: <api key>"
    
    import requests
    
    requests.post('https://test.prometeo.qualia.uy/transfer/preprocess', headers={'X-API-Key': '<api key>'}, params={
      "key": "959602df-d3ee-4898-b6d8-a28a2c7486fb"
    }, data={
      "origin_account": "002206345988",
      "destination_institution": 0,
      "destination_account": "001002363321",
      "currency": "UYU",
      "amount": 1.3,
      "concept": "descripcion de transferencia",
      "destination_owner_name": "John Doe",
      "branch": 62
    })
    
    var request = require('request');
    
    request.post({
      "url": "https://test.prometeo.qualia.uy/transfer/preprocess",
      "json": true,
      "headers": {
        "X-API-Key": "<api key>"
      },
      "form": {
        "origin_account": "002206345988",
        "destination_institution": 0,
        "destination_account": "001002363321",
        "currency": "UYU",
        "amount": 1.3,
        "concept": "descripcion de transferencia",
        "destination_owner_name": "John Doe",
        "branch": 62
      },
      "qs": {
        "key": "959602df-d3ee-4898-b6d8-a28a2c7486fb"
      }
    });
    
    {
        "result": {
            "approved": true,
            "authorization_devices": [
                {
                    "data": ["F-4", "B-2", "G-7"],
                    "type": "cardCode"
                },
                {
                    "data": null,
                    "type": "pin"
                }
            ],
            "message": null,
            "request_id": "0b7d6b32d1be4c11bde21e7ddc08cc36"
        },
        "status": "success"
    }
    

    Parámetro:

    Respuesta:

    Confirmar Transferencia

    Endpoint: POST /transfer/confirm

    POST /transfer/confirm?key=959602df-d3ee-4898-b6d8-a28a2c7486fb HTTP/1.1
    Host: test.prometeo.qualia.uy
    Accept: application/json
    X-API-Key: <api key>
    
    request_id=0b7d6b32d1be4c11bde21e7ddc08cc36&authorization_type=cardCode&authorization_data=1%2C2%2C3
    
    curl -X POST "https://test.prometeo.qualia.uy/transfer/confirm?key=959602df-d3ee-4898-b6d8-a28a2c7486fb" -d 'request_id=0b7d6b32d1be4c11bde21e7ddc08cc36&authorization_type=cardCode&authorization_data=1%2C2%2C3' -H "X-API-Key: <api key>"
    
    import requests
    
    requests.post('https://test.prometeo.qualia.uy/transfer/confirm', headers={'X-API-Key': '<api key>'}, params={
      "key": "959602df-d3ee-4898-b6d8-a28a2c7486fb"
    }, data={
      "request_id": "0b7d6b32d1be4c11bde21e7ddc08cc36",
      "authorization_type": "cardCode",
      "authorization_data": "1,2,3"
    })
    
    var request = require('request');
    
    request.post({
      "url": "https://test.prometeo.qualia.uy/transfer/confirm",
      "json": true,
      "headers": {
        "X-API-Key": "<api key>"
      },
      "form": {
        "request_id": "0b7d6b32d1be4c11bde21e7ddc08cc36",
        "authorization_type": "cardCode",
        "authorization_data": "1,2,3"
      },
      "qs": {
        "key": "959602df-d3ee-4898-b6d8-a28a2c7486fb"
      }
    });
    
    {
        "status": "success",
        "transfer": {
            "message": "",
            "success": true
        }
    }
    

    Parámetro:

    Listar Instituciones para Transferencias

    Endpoint: POST /transfer/destinations

    GET /transfer/destinations?key=959602df-d3ee-4898-b6d8-a28a2c7486fb HTTP/1.1
    Host: test.prometeo.qualia.uy
    Accept: application/json
    X-API-Key: <api key>
    
    
    
    curl -X GET "https://test.prometeo.qualia.uy/transfer/destinations?key=959602df-d3ee-4898-b6d8-a28a2c7486fb"  -H "X-API-Key: <api key>"
    
    import requests
    
    requests.get('https://test.prometeo.qualia.uy/transfer/destinations', headers={'X-API-Key': '<api key>'}, params={
      "key": "959602df-d3ee-4898-b6d8-a28a2c7486fb"
    })
    
    var request = require('request');
    
    request.get({
      "url": "https://test.prometeo.qualia.uy/transfer/destinations",
      "json": true,
      "headers": {
        "X-API-Key": "<api key>"
      },
      "qs": {
        "key": "959602df-d3ee-4898-b6d8-a28a2c7486fb"
      }
    });
    
    {
        "destinations": [
            {
                "id": 0,
                "name": "SANTANDER"
            },
            {
                "id": 1,
                "name": "B.R.O.U."
            },
            {
                "id": 91,
                "name": "B.H.U."
            },
            {
                "id": 110,
                "name": "BANDES"
            },
            ...
        ],
        "status": "success"
    }
    

    Listar Proveedores

    Endpoint: GET /provider/

    GET /provider/? HTTP/1.1
    Host: test.prometeo.qualia.uy
    Accept: application/json
    X-API-Key: <api key>
    
    
    
    curl -X GET "https://test.prometeo.qualia.uy/provider/?"  -H "X-API-Key: <api key>"
    
    import requests
    
    requests.get('https://test.prometeo.qualia.uy/provider/', headers={'X-API-Key': '<api key>'})
    
    var request = require('request');
    
    request.get({
      "url": "https://test.prometeo.qualia.uy/provider/",
      "json": true,
      "headers": {
        "X-API-Key": "<api key>"
      }
    });
    

    Respuesta

    {
        "providers": [
            {
                "code": "test",
                "country": "UY",
                "name": "Test Provider"
            },
            ...
        ],
        "status": "success"
    }
    

    Un proveedor es una fuente de datos financieros.

    Respuesta:

    Probar en el Sandbox

    Detalle de Proveedor

    Endpoint GET /provider/{code}/

    GET /provider/test/? HTTP/1.1
    Host: test.prometeo.qualia.uy
    Accept: application/json
    X-API-Key: <api key>
    
    
    
    curl -X GET "https://test.prometeo.qualia.uy/provider/test/?"  -H "X-API-Key: <api key>"
    
    import requests
    
    requests.get('https://test.prometeo.qualia.uy/provider/test/', headers={'X-API-Key': '<api key>'})
    
    var request = require('request');
    
    request.get({
      "url": "https://test.prometeo.qualia.uy/provider/test/",
      "json": true,
      "headers": {
        "X-API-Key": "<api key>"
      }
    });
    

    Respuesta

    {
        "provider": {
            "auth_fields": [
                {
                    "interactive": false,
                    "name": "username",
                    "type": "text"
                },
                {
                    "interactive": false,
                    "name": "password",
                    "type": "password"
                }
            ],
            "country": "UY",
            "name": "test"
        },
        "status": "success"
    }
    

    Respuesta

    Probar en el Sandbox