curl --request POST \
  --url https://api.ext.pix.dbs.moneyp.dev.br/api/Recurso/Transferir \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'IdempotencyKey: <idempotencykey>' \
  --header 'IgnoraHandshake: <ignorahandshake>' \
  --data '{
  "dadosEnvioPorChave": {
    "ticket": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "chave": "<string>",
    "tipoChave": 0
  },
  "dadosEnvioPorConta": {
    "contaDestino": {
      "agencia": "<string>",
      "agenciaDigito": "<string>",
      "conta": "<string>",
      "contaDigito": "<string>",
      "contaPgto": "<string>",
      "tipoConta": 1,
      "modeloConta": 1
    },
    "ispbDestino": "<string>",
    "nomeDestino": "<string>",
    "documentoFederalDestino": "<string>"
  },
  "valor": 123,
  "codigoOperacaoCliente": "<string>",
  "descricaoCliente": "<string>",
  "prioridade": 0,
  "contaOrigem": {
    "agencia": "<string>",
    "agenciaDigito": "<string>",
    "conta": "<string>",
    "contaDigito": "<string>",
    "contaPgto": "<string>",
    "tipoConta": 1,
    "modeloConta": 1
  },
  "informacoesAdicionais": "<string>",
  "idConciliacaoRecebedor": "<string>",
  "tpQRCode": 1,
  "codigoLeituraQRCode": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}'
{
  "sucesso": true,
  "mensagem": "<string>",
  "codigoTransacao": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Por meio deste endpoint, o parceiro pode efetuar transferências de valores através de uma chave Pix, dados bancários ou por QrCode.

Em produção a utilização de HandShake e HMAC é obrigatória.

Transferência via Chave PIX: Neste modelo para que o cliente obtenha sucesso na requisição é necessário realizar a consulta da chave no endpoint /api/Chave/Consultar para obter o “ticket” nesse caso é obrigatória a informação da chave que receberá a transferência do recurso.

Transferência via Dados Bancários: Neste modelo para que o cliente obtenha sucesso na requisição é necessário informar os dados da conta destino, incluindo agencia, conta, tipo de conta, modelo de conta, ISPB do destino, nome e documento federal beneficiário.

Transferência via QrCode: Neste modelo para que o cliente obtenha sucesso na requisição é necessário realizar a consulta da chave no endpoint /api/QRCode/Ler para obter o “codigoLeituraQRCode

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

​
dadosEnvioPorChave
object

Detalhes da Chave PIX para Transação (Obrigatório para transações via Chave).

​
dadosEnvioPorConta
object

Detalhes da Conta para Transação (Obrigatório para transações via Conta).

​
valor
number

Valor da Transação.

​
codigoOperacaoCliente
string | null

Identificador fornecido pelo remetente para facilitar a conciliação e o rastreamento da transação.

​
descricaoCliente
string | null

Descrição opcional fornecida pelo Remetente.

​
prioridade
enum<integer>

0 = URGENTE; 1 = NORMAL

Available options:
0,
1
​
contaOrigem
object

Objeto detalhado de informações da Conta Bancária do Remetente.

​
informacoesAdicionais
string | null

Detalhes adicionais relacionados à Transação PIX.

​
idConciliacaoRecebedor
string | null
​
tpQRCode
enum<integer>

1 = Estatico; 2 = Dinamico

Available options:
1,
2
​
codigoLeituraQRCode
string

Indentificador UUID de leitura do QR Code.

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.

​
codigoTransacao
string

Código UUID da transação.

Esta página foi útil?