Webhooks – PIX OUT

Webhooks são notificações automáticas que a Cashtime envia ao seu sistema sempre que o status de uma operação de pagamento (PIX OUT) é atualizado. Assim, você recebe em tempo real o resultado dos seus envios, sem precisar ficar consultando a API.

Como funciona

Defina seu endpoint
Ao criar a transação de PIX OUT, informe o campo baasPostbackUrl com a URL do seu servidor que receberá as notificações.
Receba a notificação
Quando o status da operação mudar, a Cashtime faz um POST para o seu endpoint com o JSON abaixo.
Confirme o recebimento
Seu servidor deve responder com HTTP 2xx para indicar que processou o evento.
Reenvios automáticos
Se não houver resposta 2xx, tentaremos reenviar a notificação algumas vezes.

Campos do Payload

Campo	Descrição
id	Identificador interno da transação
amount	Valor enviado em centavos
taxes	Taxas aplicadas em centavos
pixKey	Chave Pix de destino
pixKeyType	Tipo da chave Pix (CPF, CNPJ, phone, email ou random)
externalCode	Seu identificador próprio (se enviado)
withdrawStatusId	Novo status da operação
createdAt	Data e hora de criação (ISO 8601)
updatedAt	Data e hora da última atualização (ISO 8601)

Status possíveis

• AwaitingAprove — aguardando aprovação
• PendingProcessing — em fila de processamento
• Processing — processando
• Successful — pagamento concluído
• Failure — pagamento falhou
• Canceled — pagamento cancelado
• Reversed — valor estornado

Exemplo de Payload

{
  "id": "64905df5-ee95-42f7-bc79-6bbff92ee055",
  "amount": 100,
  "taxes": 100.1,
  "pixKey": "66999893822",
  "pixKeyType": "phone",
  "externalCode": "pedido_123",
  "withdrawStatusId": "Reversed",
  "createdAt": "2025-03-05T18:55:22.919Z",
  "updatedAt": "2025-03-05T18:55:43.519Z"
}