1 - Criar Chave Pix

Criar chave PIX por MFA

curl --request POST \
  --url https://api.ext.pix.dbs.moneyp.com.br/api/v2/Chave \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'IdempotencyKey: <idempotencykey>' \
  --header 'IgnoraHandshake: <ignorahandshake>' \
  --data '
{
  "contaDto": {
    "agencia": "<string>",
    "agenciaDigito": "<string>",
    "conta": "<string>",
    "contaDigito": "<string>",
    "contaPgto": "<string>"
  },
  "chave": "<string>",
  "codigoAutenticacao": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "codigoMfa": "<string>"
}
'

{
  "sucesso": true,
  "mensagem": "<string>"
}

Criar chave PIX por MFA

curl --request POST \
  --url https://api.ext.pix.dbs.moneyp.com.br/api/v2/Chave \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'IdempotencyKey: <idempotencykey>' \
  --header 'IgnoraHandshake: <ignorahandshake>' \
  --data '
{
  "contaDto": {
    "agencia": "<string>",
    "agenciaDigito": "<string>",
    "conta": "<string>",
    "contaDigito": "<string>",
    "contaPgto": "<string>"
  },
  "chave": "<string>",
  "codigoAutenticacao": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "codigoMfa": "<string>"
}
'

{
  "sucesso": true,
  "mensagem": "<string>"
}

Por meio deste endpoint, o parceiro pode registrar uma nova chave Pix, ampliando suas opções de recebimento. As opções de chave incluem: CPF/CNPJ, e-mail, número de celular ou uma chave aleatória.

Para utilizar este endpoint é necessário realizar a dupla verificação através de MFA para realizar a criação de de uma chave que utilize “e-mail” ou “telefone”

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/v2/Chave	Código da conta não identificado na requisição. Verifique autenticação AuthCompany
/api/v2/Chave	Erro - Generico Ocorreu um erro na requisição
/api/v2/Chave	Erro SBP
/api/v2/Chave	Conta inválida
/api/v2/Chave	Agência inválida
/api/v2/Chave	Necessário informar Conta + ContaDigito ou ContaPgto
/api/v2/Chave	Conta inválida
/api/v2/Chave	Conta != Ativa
/api/v2/Chave	Operador não encontrado
/api/v2/Chave	Parceiro não autorizado para esta conta
/api/v2/Chave	É necessário informar um código de autenticação
/api/v2/Chave	É necessário informar o código mfa da autenticação
/api/v2/Chave	MFA não encontrado com este código de autenticação, solicite um novo
/api/v2/Chave	Tipo chave pix inválido para o tipo informado na solicitação de MFA
/api/v2/Chave	Tipo chave pix inválido para o tipo informado na solicitação de MFA
/api/v2/Chave	Chave inválida para o MFA solicitado
/api/v2/Chave	Este MFA não é compatível com a chave informada
/api/v2/Chave	Token inválido ou já expirou
/api/v2/Chave	Dados do correntista titular não encontrados
/api/v2/Chave	Para continuar, o telefone informado deverá constar nos dados do correntista principal
/api/v2/Chave	Para continuar, o e-mail informado deverá constar nos dados do correntista principal
/api/v2/Chave	Não foi possível identificar o correntista titular da conta
/api/v2/Chave	Correntista não permitido para esta conta
/api/v2/Chave	Não é possível criar uma chave pix para uma conta vinculada
/api/v2/Chave	Correntista não informado
/api/v2/Chave
/api/v2/Chave	Não é permitido informar o campo ‘chave’ para criar chave do tipo
/api/v2/Chave	Tipo de chave inválida. Correntista não é pessoa física
/api/v2/Chave	Tipo de chave inválida. Correntista não é pessoa jurídica
/api/v2/Chave	Chave não pode ser informada para tipo aleatória
/api/v2/Chave	Chave inválida. Telefone incorreto
/api/v2/Chave	E-mail não informado
/api/v2/Chave	E-mail não pode conter caracteres maiúsculos
/api/v2/Chave	E-mail 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

contaDto

object

Objeto detalhado da conta bancária.*

Show child attributes

tipoChave

enum<integer>

Tipo da chave.*

Valores: 0 - CPF 1 - CNPJ 2 - TELEFONE 3 - EMAIL 4 - EVP

Opções disponíveis:

0,

1,

2,

3,

4

chave

string | null

Chave pix a ser criada.*

codigoAutenticacao

string<uuid>

Identificador único (UUID) para validar a autenticidade da solicitação.*

codigoMfa

string | null

Código recebido para autenticaçâo multifator (MFA).*

Resposta

Success

sucesso

boolean

mensagem

string | null

Cartões 2 - Listar Chaves Pix

Documentation Index

Autorizações

Cabeçalhos

Corpo

Resposta