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 or if explicitly required by the partner.

How It Works

First Payment

After the end user successfully makes its first deposit, Eulen will lock the deposit and send a payment 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.

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#