Referência do Core/Reembolso
POST

Solicitar reembolso

Solicita o reembolso de um pagamento Pix.

POST/v1/payments/{id}/refunds
https://integrate.api.kyvopay.com.br
cURL
curl -X POST "https://api.kyvopay.com.br/v1/payments/ID_ID/refunds" \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN" \
  -H "X-Business-Id: UUID_DA_EMPRESA" \
  -H "Content-Type: application/json" \
  -d '{}'

Autenticação

X-API-Keystring · headerobrigatório

Use a chave ky_... criada em Integrações → Chaves de API no painel KyvoPay.

Operação do Core implementada por DashboardController.requestRefund().

Endpoint

POST/v1/payments/{id}/refunds

Autenticação

Sessão do lojista. Requer JWT válido e empresa ativa/selecionada; o Core aplica MerchantBusinessGuard.

Guards encontrados no controller: JwtAuthGuard, MerchantBusinessGuard.

Requisição

Parâmetros de rota

idstringobrigatório
Identificador usado por esta rota.

Implementação no Core

Arquivo: modules/dashboard/dashboard.controller.ts
Handler: DashboardController.requestRefund()

Nota

Esta página foi sincronizada do Core atual. Campos específicos de corpo e resposta devem permanecer alinhados ao controller e aos DTOs do Core.

Precisa de ajuda? Fale com o suporte
© 2026 KyvoPay