20 - Solicitar MFA para Reivindicação

Scopes:

api.pix api.reivindicacao.solicitarmfa

Endpoint usado para solicitar autenticação multifatorial.

cURL

curl --request POST \
  --url https://api.ext.pix.dbs.moneyp.com.br/api/Reivindicacao/SolicitarMFA \
  --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>"
  },
  "destinoEnvio": "<string>"
}
'

200

{
  "sucesso": true,
  "mensagem": "<string>",
  "codigoAutenticacao": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Por meio deste endpoint, o parceiro pode enviar uma solicitação de autenticação de múltiplos fatores (MFA), quando executar uma reivindicação de chave.

Este processo é muito importante pois desta forma o parceiro pode comprovar a titularidade da chave.

Mostrar Mensagens de requisições com erro

O retorno de uma requisição com status HTTP 400 (Bad Request) pode incluir as seguintes mensagens de erro:

Endpoint	Mensagem de erro
/api/Reivindicacao/SolicitarMFA	Dados do correntista titular não encontrados
/api/Reivindicacao/SolicitarMFA	Para continuar, o telefone informado deverá constar nos dados do correntista principal
/api/Reivindicacao/SolicitarMFA	Para continuar, o e-mail informado deverá constar nos dados do correntista principal
/api/Reivindicacao/SolicitarMFA	O endereço de e-mail é inválido
/api/Reivindicacao/SolicitarMFA	O número de telefone é inválido
/api/Reivindicacao/SolicitarMFA	O número de telefone é inválido

Autorizações

Authorization · string · header · obrigatório

Copie 'Bearer ' + token

Cabeçalhos

IdempotencyKey · string · obrigatório

IgnoraHandshake · boolean · padrão: true · obrigatório

(somente em homologação)

Corpo

application/jsontext/jsonapplication/*+json

conta · object

Objeto detalhado da conta bancária.*

Show child attributes

tipoMfa · enum<integer>

Tipo MFA.*

Valores: 1 - App 2 - Sms 3 - Email 6 - DbsRetaguarda 7 - WhatsApp

Opções disponíveis: 1, 2, 3, 6, 7

destinoEnvio · string | null

Destino para o código de autenticação MFA.*

Resposta

200

application/json

Success

sucesso · boolean

mensagem · string | null

codigoAutenticacao · string<uuid>