What is a login?

A login represents a connection attempt from Palenca to an external platform such as Didi, Rappi, Uber, etc.

When a login is first created, it will have a pending status, which is a transitory status. Depending on whether Palenca succeeds or not in making the connection attempt, the login status will update to either success, incomplete, or error. The following diagram illustrates this, and we will explain it in detail on this page.

Login Statuses

Successful Connections

If we were able to connect to a given Gig platform with the user's credentials, we will update the login status to success. We will extract as much data as possible.

Incomplete Connections

Incomplete gig logins refer to processes where the user did not perform all the necessary steps to successfully log in to a Gig platform. For example, they did not provide the correct OTP code they received in their phone or they mistyped their credentials. The user needs to take corrective action and try again.

Errors

Connections can fail whenever we encounter unexpected technical problems while trying to connect to a platform. The possible errors are many, but in all cases the login will have a final status of error.

Recap

Status	Description	Actions to take
success	The user's connection was successful and we extracted as much information as possible.	At this point it is possible to make GET requests to our API for income or profile information.
incomplete	The connection failed for non-technical reasons.	The user needs to take corrective action and try again.
pending	We are processing the connection.	Wait 1 to 10 minutes for a status update.
error	An error occurred while trying to connect.	Please contact support or try again in a few minutes.

📘
Information
Since we only have 4 possible login status but there are many different scenarios, we often provide more context in a field called status_details. See the list logins endpoint example responses to understand better what this looks like.