curl --request POST \
  --url https://api.ext.pix.dbs.moneyp.dev.br/api/Mfa/Solicitar \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'IdempotencyKey: <idempotencykey>' \
  --header 'IgnoraHandshake: <ignorahandshake>' \
  --data '{
  "conta": {
    "agencia": "<string>",
    "agenciaDigito": "<string>",
    "conta": "<string>",
    "contaDigito": "<string>",
    "contaPgto": "<string>",
    "tipoConta": 1,
    "modeloConta": 1
  },
  "tipoMfa": 1,
  "destinoEnvio": "<string>"
}'
{
  "sucesso": true,
  "mensagem": "<string>",
  "codigoAutenticacao": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Through this endpoint, partners can request multi-factor authentication (MFA), which provides an additional layer of security for creating a Pix key in the “email” or “cell phone number” format. After registration, a token will be sent to the channel associated with the key.

Requirements:

The token is sent according to the key type, either by SMS or email.

Authorizations

​
Authorization
string
header
required

Copie 'Bearer ' + token

Headers

​
IdempotencyKey
string
required

Chave única para garantir que uma operação seja executada apenas uma vez.

​
IgnoraHandshake
boolean
default:true
required

(somente em homologação)

Body

​
conta
object

Objeto detalhado da Conta.

​
tipoMfa
enum<integer>

1 = App; 2 = Sms; 3 = Email; 6 = DbsRetaguarda; 7 = WhatsApp

Available options:
1,
2,
3,
6,
7
​
destinoEnvio
string | null

Destino para o código MFA.

Response

200 - application/json
Success
​
sucesso
boolean

Indica se a operação foi realizada com sucesso.

​
mensagem
string | null

Descrição detalhada do resultado da operação, incluindo informações sobre erros ou mensagens complementares.

​
codigoAutenticacao
string

Código UUID identificador da autenticação multifator gerada.

Was this page helpful?