Cash Out
Comprovante do Cashout
GET
/v1/cashout/receipt/:cashoutIdRetorna o comprovante de um cashout específico em formato HTML. Apenas o criador do cashout pode acessar seu comprovante.
Formato da Resposta
Este endpoint retorna HTML, não JSON. Configure seu cliente HTTP para receber texto (
responseType: 'text' no axios).Parâmetros de URL
| Campo | Tipo | Descrição |
|---|---|---|
cashoutIdobrigatório | string (UUID) | ID único do cashout retornado na criação. |
Exemplo em JavaScript
Node.js (axios)javascript
const axios = require('axios');
async function consultarReceipt(cashoutId) {
const response = await axios.get(
`${BASE_URL}/v1/cashout/receipt/${cashoutId}`,
{
headers: { 'api-secret': process.env.API_SECRET },
responseType: 'text' // Importante: receber como texto (HTML)
}
);
return response.data; // HTML do comprovante
}Regras de Negócio
- Apenas o usuário que criou o cashout pode consultar o comprovante
- O cashoutId deve ser um UUID válido
- A resposta é retornada como HTML, não JSON
- O API Secret deve pertencer ao criador do cashout
Erros Possíveis
401"API Secret não fornecida"403"Você não tem permissão para acessar este cashout"404"Cashout não encontrado"GET
https://api.genesys.finance/v1/cashout/receipt/{cashoutId}Headers
api-secret: seu_api_secret_aquicURL
curl -X GET "https://api.genesys.finance/v1/cashout/receipt/bb0fb3cb-015f-4604-8532-133a78c0c3e1" \
-H "api-secret: sua-api-secret-aqui"Response 200 (HTML)
<!DOCTYPE html>
<html>
<head>
<title>Comprovante de Cashout</title>
</head>
<body>
<div class="receipt">
<h1>Comprovante de Saque</h1>
<p><strong>ID:</strong> bb0fb3cb-015f-...</p>
<p><strong>Valor:</strong> R$ 250.00</p>
<p><strong>Status:</strong> approved</p>
<p><strong>Data:</strong> 2024-01-15T10:30:00Z</p>
</div>
</body>
</html>