🔐 Pix2FA

Pix2FA is a security feature designed to protect users from scams and fraud, particularly “man-in-the-middle” attacks.

This verification step applies only to new users when the partner has the Pix2FA feature enabled.

Alternatively, the feature can be activated for a specific deposit when explicitly required by the partner (via the Deposit endpoint, using the parameter "pix2fa": true).

How It Works

First Payment

After the end user successfully makes its first deposit, Eulen will lock the deposit and send a payment of R$ 0,01 (one BRL cent) to the user's bank account (the same used for the deposit).

Verification Code

This R$ 0,01 payment will include a 6-digit verification code in the payment description. The end user must provide this code to the Eulen Partner through the partner’s usual interface.

Partner Validation

In order to unlock the deposit, the Eulen Partner must submit the provided Pix2FA code to Eulen via:

the pix2fa endpoint, or

the /pix2fa telegram bot command.

Once the code is correct and validated by Eulen, the deposit will be unlocked and the DePix will be sent.

Checking Pending Verifications

Partners can identify deposits awaiting Pix2FA verification by querying deposits with the pending_pix2fa status through the:

deposit-status endpoint, or

deposits endpoint.

Expiration

By default, if a transaction remains in the pending_pix2fa state for more than 48 hours, the DePix will be sent automatically after this period.
You may contact our support team via Telegram (@eulen_support) to request the disabling of this default behavior.

Custom Pix2FA message

Our system will provide a standard message with the 6-digit code for the end user. However, you can customize this message using the pix2faMessage parameter. This is completely optional. Please refer to Deposit endpoint for more details.

Note: If you want to use a custom message, your string must include a %s placeholder for injection of the Pix2FA code.

Example

Deposit request (for more details, please refer to Deposit endpoint)

{
  "amountInCents": 100,
  "pix2fa": true,
  "pix2faMessage": "Confirme seu deposito enviando no nosso app o codigo: %s. Nao compartilhe"
}

Pix Messaging Feature

If your intention is to only display a message without blocking the deposit, DO NOT set "pix2fa": true and use pix2faMessage normally. For more details, please refer to Pix Messaging Feature

How It Works#

First Payment#

Verification Code#

Partner Validation#

Checking Pending Verifications#

Expiration#

Custom Pix2FA message#

Example#

Pix Messaging Feature#