Skip to main content
POST/transfer-internal/create

Corpo da requisição

amountnumberrequired

Valor em reais, com até duas casas decimais. De R$ 5,00 a R$ 1.000,00 por operação.

recipientEmailstringrequired

E-mail de uma conta ativa, diferente da sua.

Descrição que identifica a operação.

Headers

Idempotency-Keystringrequired

Identificador único de até 128 caracteres. Preserve a chave e o corpo ao repetir a operação.

Autorização

X-API-Keystringrequired

Chave VibeCash com permissão para esta operação.

Resposta

201 application/json
successbooleanrequired

Indica se a operação foi concluída pela API.

messagestringrequired

Mensagem da operação.

dataobjectrequired

Dados retornados pela operação.

Show child attributes
idstring

Identificador da operação.

statusstring

Situação atual do pagamento ou envio.

amountnumber

Valor bruto ou informado, em reais.

feeAmountnumber

Taxa da operação, em reais.

netAmountnumber

Líquido da entrada ou total debitado de uma saída.

Valor entregue ao destinatário.

Total debitado da carteira.

createdAtstring

Data e hora da criação em formato ISO.

requestIdstring

Identificador da requisição.

Erros

As falhas retornam o envelope com success: false. Consulte erros e códigos HTTP para interpretar validação, permissão, conflito e saldo insuficiente.

curl --request POST \
  --url 'https://seu-dominio/v1/transfer-internal/create' \
  --header 'X-API-Key: tp_live_SUA_CHAVE' \
  --header 'Idempotency-Key: operacao-unica-123' \
  --header 'Content-Type: application/json' \
  --data '{"amount":5,"recipientEmail":"[email protected]","description":"Transferência interna"}'
{
  "success": true,
  "message": "Operação concluída",
  "data": {
    "id": "internal_exemplo",
    "amount": 5,
    "feeAmount": 0,
    "netAmount": 5,
    "recipientAmount": 5,
    "totalDebit": 5,
    "status": "COMPLETED",
    "createdAt": "2026-11-10T15:00:00.000Z"
  },
  "requestId": "req_exemplo"
}

Pesquisar documentação

POST

Transferência interna

Envie saldo a outra conta VibeCash pelo e-mail, sem tarifa.

Authorization
Body
Expand 1 optional fields