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

Through this endpoint, partners can transfer funds via Pix key, bank account details, or QR code.

In production, the use of HandShake and HMAC is mandatory.

Transfer via Pix Key: For a successful request in this model, the client must consult the key using the /api/Chave/Consultar endpoint to obtain the “ticket.” In this case, providing the key that will receive the transfer is required.

Transfer via Bank Account Details: In this model, the client must provide the destination account details, including branch, account number, account type, account model, destination ISPB, beneficiary’s name, and federal document.

Transfer via QR Code: For a successful request in this model, the client must consult the key using the /api/QRCode/Ler endpoint to obtain the “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.