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.

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Example

{
    "pixTwoFactorCode": "398978",
    "qrId": "019a98275b48759c89d02ee03341ac5d"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Headers

Body

Examples

SuccessException

{
    "response": {
        "message": "Transaction ID fitbank_EE36F4423AACC99EEE70001 verified pix2FA code successfully."
    },
    "async": false
}

How It Works#

First Payment#

Verification Code#

Partner Validation#

Checking Pending Verifications#

Expiration#