Multi factor authentication

OpenData Q&A
1

What are the ways to do mmulti-factorauthentication in the paybook?

2

Hi @demoprod!

The are multiple ways to do the multi-factor authentication, It depends on the site, for example, some institutions like “BBVA Bancomer Empresas” require to send a Token, another one requires a captcha, and then are others who require Token and Captcha.

When you create a credential you receive in the response an id_job and a URL to consult the status of the credential:

{
    "rid": "692daa38-796a-404a-8741-40c70b0da9f8",
    "code": 200,
    "errors": null,
    "status": true,
    "message": null,
    "response": {
        "id_credential": "5f0a1d29e376b01a085ce85a",
        "id_job_uuid": "5f0c9f68acc3df499c4eb0b2",
        "id_job": "5f0c9f68acc3df499c4eb0b3",
        "is_new": 0,
        "username": "t**t",
        "ws": "wss://sync.paybook.com/v1/status/5f0c9f68acc3df499c4eb0b3",
        "status": "https://sync.paybook.com/v1/jobs/5f0c9f68acc3df499c4eb0b3/status",
        "twofa": "https://sync.paybook.com/v1/jobs/5f0c9f68acc3df499c4eb0b3/twofa"
    }
}

If you consult the status URL via GET and using the session token as authentication to the API you’ll get something like this:

{
    "rid": "77613182-732f-459b-a7d6-845e9ce0edea",
    "code": 200,
    "errors": null,
    "status": true,
    "message": null,
    "response": [
        {
            "code": 100
        },
        {
            "code": 101
        },
        {
            "code": 410,
            "address": "https://sync.paybook.com/v1/jobs/5f0c9ff66a49e10fd5478487/twofa",
            "twofa": [
                {
                    "name": "token",
                    "type": "text",
                    "label": "Introduzca Clave ASD",
                    "challenge": "89704371"
                },
                {
                    "name": "challenge",
                    "type": "challenge",
                    "label": "89704371"
                }
            ]
        }
    ]
}

There are indicated the TWOFA challenge, you only need to complete it and send it to the URL in the field “address”.

Additionally, all the use cases are covered in the Sandbox ACME Institutions, also the Syncfy Widget cover all the use cases.

1 me gusta