Saques

Transferir via Pix

POST/v1/wallet/pix-transfer

Base URL Produção:https://api.validapay.com.br

Base URL Sandbox:https://sandbox.validapay.com.br

Autenticação

bearerAuthorizationstring · header · obrigatório

Envie no header:

Authorization: Bearer {{token}}

Envia um valor diretamente para uma chave Pix, sem precisar de conta bancária cadastrada.

Enviar transferência PIX

Realiza uma transferência PIX a partir do saldo da carteira para qualquer conta bancária via chave PIX. Diferente do saque, esta operação permite informar um valor livre sem necessidade de pré-cadastro de destinatário.

Campo	Obrig.	Tipo	Descrição
`amount`	✅	number	Valor da transferência em reais
`pixKey`	✅	string	Chave PIX do destinatário
`pixKeyType`	✅	string	Tipo da chave: `CPF` `CNPJ` `EMAIL` `PHONE` `EVP`
`description`	❌	string	Mensagem/descrição para o destinatário
`accountId`	❌	string	M2M: conta de origem

Body

application/json

Content-Type:application/json

{
  "amount": 150.0,
  "pixKey": "11999998888",
  "pixKeyType": "PHONE",
  "description": "Pagamento de serviço",
  "accountId": null
}

Schema

Field	Type	Required	Description
amount	number	-	-
pixKey	string	-	-
pixKeyType	string	-	-
description	string	-	-
accountId	object	-	-

Headers

Name	Type	Value	Required
Content-Type	-	application/json	Optional

← Anterior

Listar Saques

Validar Chave Pix

const url = 'https://sandbox.validapay.com.br/v1/wallet/pix-transfer';

const options = {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer {{token}}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "amount": 150.0,
  "pixKey": "11999998888",
  "pixKeyType": "PHONE",
  "description": "Pagamento de serviço",
  "accountId": null
})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response Examples

201201

{
  "transferId": "trf_xxx",
  "amount": 150.0,
  "status": "PROCESSING",
  "pixKey": "11999998888",
  "endToEndId": "E...",
  "createdAt": "2024-01-15T10:30:00Z"
}

400400

{
  "code": "INSUFFICIENT_BALANCE"
}

← Anterior

Listar Saques

Validar Chave Pix