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>"
}
'import requests
url = "https://api.ext.pix.dbs.moneyp.com.br/api/v2/Chave"
payload = {
"contaDto": {
"agencia": "<string>",
"agenciaDigito": "<string>",
"conta": "<string>",
"contaDigito": "<string>",
"contaPgto": "<string>"
},
"chave": "<string>",
"codigoAutenticacao": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"codigoMfa": "<string>"
}
headers = {
"IdempotencyKey": "<idempotencykey>",
"IgnoraHandshake": "<ignorahandshake>",
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
IdempotencyKey: '<idempotencykey>',
IgnoraHandshake: '<ignorahandshake>',
Authorization: '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
contaDto: {
agencia: '<string>',
agenciaDigito: '<string>',
conta: '<string>',
contaDigito: '<string>',
contaPgto: '<string>'
},
chave: '<string>',
codigoAutenticacao: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
codigoMfa: '<string>'
})
};
fetch('https://api.ext.pix.dbs.moneyp.com.br/api/v2/Chave', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ext.pix.dbs.moneyp.com.br/api/v2/Chave",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'contaDto' => [
'agencia' => '<string>',
'agenciaDigito' => '<string>',
'conta' => '<string>',
'contaDigito' => '<string>',
'contaPgto' => '<string>'
],
'chave' => '<string>',
'codigoAutenticacao' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'codigoMfa' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json",
"IdempotencyKey: <idempotencykey>",
"IgnoraHandshake: <ignorahandshake>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.ext.pix.dbs.moneyp.com.br/api/v2/Chave"
payload := strings.NewReader("{\n \"contaDto\": {\n \"agencia\": \"<string>\",\n \"agenciaDigito\": \"<string>\",\n \"conta\": \"<string>\",\n \"contaDigito\": \"<string>\",\n \"contaPgto\": \"<string>\"\n },\n \"chave\": \"<string>\",\n \"codigoAutenticacao\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"codigoMfa\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("IdempotencyKey", "<idempotencykey>")
req.Header.Add("IgnoraHandshake", "<ignorahandshake>")
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.ext.pix.dbs.moneyp.com.br/api/v2/Chave")
.header("IdempotencyKey", "<idempotencykey>")
.header("IgnoraHandshake", "<ignorahandshake>")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"contaDto\": {\n \"agencia\": \"<string>\",\n \"agenciaDigito\": \"<string>\",\n \"conta\": \"<string>\",\n \"contaDigito\": \"<string>\",\n \"contaPgto\": \"<string>\"\n },\n \"chave\": \"<string>\",\n \"codigoAutenticacao\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"codigoMfa\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ext.pix.dbs.moneyp.com.br/api/v2/Chave")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["IdempotencyKey"] = '<idempotencykey>'
request["IgnoraHandshake"] = '<ignorahandshake>'
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"contaDto\": {\n \"agencia\": \"<string>\",\n \"agenciaDigito\": \"<string>\",\n \"conta\": \"<string>\",\n \"contaDigito\": \"<string>\",\n \"contaPgto\": \"<string>\"\n },\n \"chave\": \"<string>\",\n \"codigoAutenticacao\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"codigoMfa\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"sucesso": true,
"mensagem": "<string>"
}{
"sucesso": true,
"mensagem": "<string>"
}{
"sucesso": true,
"mensagem": "<string>"
}PIX
1 - Criar Chave Pix
Scopes:
api.pix api.chave.criarCriar 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>"
}
'import requests
url = "https://api.ext.pix.dbs.moneyp.com.br/api/v2/Chave"
payload = {
"contaDto": {
"agencia": "<string>",
"agenciaDigito": "<string>",
"conta": "<string>",
"contaDigito": "<string>",
"contaPgto": "<string>"
},
"chave": "<string>",
"codigoAutenticacao": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"codigoMfa": "<string>"
}
headers = {
"IdempotencyKey": "<idempotencykey>",
"IgnoraHandshake": "<ignorahandshake>",
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
IdempotencyKey: '<idempotencykey>',
IgnoraHandshake: '<ignorahandshake>',
Authorization: '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
contaDto: {
agencia: '<string>',
agenciaDigito: '<string>',
conta: '<string>',
contaDigito: '<string>',
contaPgto: '<string>'
},
chave: '<string>',
codigoAutenticacao: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
codigoMfa: '<string>'
})
};
fetch('https://api.ext.pix.dbs.moneyp.com.br/api/v2/Chave', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ext.pix.dbs.moneyp.com.br/api/v2/Chave",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'contaDto' => [
'agencia' => '<string>',
'agenciaDigito' => '<string>',
'conta' => '<string>',
'contaDigito' => '<string>',
'contaPgto' => '<string>'
],
'chave' => '<string>',
'codigoAutenticacao' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'codigoMfa' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json",
"IdempotencyKey: <idempotencykey>",
"IgnoraHandshake: <ignorahandshake>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.ext.pix.dbs.moneyp.com.br/api/v2/Chave"
payload := strings.NewReader("{\n \"contaDto\": {\n \"agencia\": \"<string>\",\n \"agenciaDigito\": \"<string>\",\n \"conta\": \"<string>\",\n \"contaDigito\": \"<string>\",\n \"contaPgto\": \"<string>\"\n },\n \"chave\": \"<string>\",\n \"codigoAutenticacao\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"codigoMfa\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("IdempotencyKey", "<idempotencykey>")
req.Header.Add("IgnoraHandshake", "<ignorahandshake>")
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.ext.pix.dbs.moneyp.com.br/api/v2/Chave")
.header("IdempotencyKey", "<idempotencykey>")
.header("IgnoraHandshake", "<ignorahandshake>")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"contaDto\": {\n \"agencia\": \"<string>\",\n \"agenciaDigito\": \"<string>\",\n \"conta\": \"<string>\",\n \"contaDigito\": \"<string>\",\n \"contaPgto\": \"<string>\"\n },\n \"chave\": \"<string>\",\n \"codigoAutenticacao\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"codigoMfa\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ext.pix.dbs.moneyp.com.br/api/v2/Chave")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["IdempotencyKey"] = '<idempotencykey>'
request["IgnoraHandshake"] = '<ignorahandshake>'
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"contaDto\": {\n \"agencia\": \"<string>\",\n \"agenciaDigito\": \"<string>\",\n \"conta\": \"<string>\",\n \"contaDigito\": \"<string>\",\n \"contaPgto\": \"<string>\"\n },\n \"chave\": \"<string>\",\n \"codigoAutenticacao\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"codigoMfa\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"sucesso": true,
"mensagem": "<string>"
}{
"sucesso": true,
"mensagem": "<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
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
Copie 'Bearer ' + token
Cabeçalhos
(somente em homologação)
Corpo
application/jsontext/jsonapplication/*+json
Objeto detalhado da conta bancária.*
Show child attributes
Show child attributes
Tipo da chave.*
Valores: 0 - CPF 1 - CNPJ 2 - TELEFONE 3 - EMAIL 4 - EVP
Opções disponíveis:
0, 1, 2, 3, 4 Chave pix a ser criada.*
Identificador único (UUID) para validar a autenticidade da solicitação.*
Código recebido para autenticaçâo multifator (MFA).*
Esta página foi útil?
⌘I

