Solicitar Saque (Withdraw)

Solicita um saque do saldo disponivel da empresa. Se a requisicao incluir uma chave PIX (pixKey), ela sera usada prioritariamente.

POST/api/Withdraw/request

Observacao

Se pixKey for omitida, o sistema automaticamente usara a chave PIX cadastrada na conta bancaria (BankAccount) da empresa.

Parametros do Body

Parametro	Tipo	Descricao
`amount`Obrigatorio	number	Valor em centavos (ex: 2500 = R$ 25,00)
`currency`Obrigatorio	string	Moeda (sempre 'BRL')
`pixKey`	string	Chave PIX de destino (opcional se cadastrada na conta)
`pixKeyType`	string	Tipo da chave: CPF, CNPJ, EMAIL, PHONE, EVP
`description`	string	Descricao do saque
`metadata`	object	Metadados customizados

Request Body

Request Bodyjson

{
  "amount": 2500,
  "currency": "BRL",
  "pixKey": "50651470862",
  "pixKeyType": "CPF",
  "description": "Saque teste via chave custom",
  "metadata": { "origem": "n8n", "pedidoId": 123 }
}

Exemplo cURL

cURLbash

curl -X POST 'https://korvopay.com/api/Withdraw/request' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'X-Client-Id: e1c98954cc404cbcb2868af9b40c7a33' \
  -H 'X-API-Key: sua-api-key-secreta' \
  -H 'Idempotency-Key: wd_test_pix_custom' \
  -d '{
    "amount": 1000,
    "currency": "BRL",
    "pixKey": "50651470862",
    "pixKeyType": "CPF",
    "description": "Saque R$10 via chave custom",
    "metadata": { "origem": "n8n", "pedidoId": 123 }
  }'