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"
}

Por meio deste endpoint, o parceiro pode solicitar a autenticação de múltiplos fatores, ou seja, a MFA. Trata-se de uma dupla validação de segurança para a criação de chave PIX no formato “e-mail” ou “telefone celular”. Após o cadastro será enviado um token para o canal ao qual a chave foi cadastrada.

Requisitos:

É utilizado de acordo com a chave, enviado por sms ou por E-mail.

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.

Esta página foi útil?