Responder

Requer autenticação
POST/v2/account/infractions/reply

Envia defesa textual + evidências (até 5 arquivos PDF/JPG/PNG, 10MB cada). Esta é a única chance de defender a transação antes do prazo deadline_at.

Form fields

Parâmetros
idstringobrigatório
infraction_id da disputa.
messagestringobrigatório
Texto da defesa (até 5000 caracteres). Explique por que o pagamento é legítimo.
files[]file
Arquivos de evidência. Tipos aceitos: PDF, JPG, PNG. Tamanho máx por arquivo: 10 MB. Máx 5 arquivos por reply.

Rate limit

10 reqs/min por credencial.

Erros

CódigoHTTPDescrição
MISSING_REQUIRED_FIELD400id ou message ausente
INFRACTION_NOT_FOUND404infraction_id inválido
INFRACTION_CLOSED409Disputa já resolvida — não aceita mais respostas
DEADLINE_EXPIRED409Prazo de resposta expirou
FILE_TOO_LARGE413Arquivo > 10 MB
TOO_MANY_FILES422Mais de 5 arquivos
UNSUPPORTED_FILE_TYPE422Tipo de arquivo não aceito
cURL
PHP
Node.js
Python
curl -X POST https://api.bspay.co/v2/account/infractions/reply \
  -H "Authorization: Bearer SEU_TOKEN" \
  -F "id=abc-uuid-1234" \
  -F "message=Pagamento legítimo. Anexos: NF-e e comprovante de entrega assinado." \
  -F "files[]=@/path/to/nf-eletronica.pdf" \
  -F "files[]=@/path/to/comprovante.jpg"

Resposta 200

{
  "success": true,
  "data": {
    "infraction_id": "abc-uuid-1234",
    "reply_id": 60,
    "status": "responded",
    "files_uploaded": 2,
    "created_at": "2026-04-30T15:00:00Z"
  },
  "request_id": "39316c1fcf4333e9f4726180",
  "timestamp": "2026-04-30T15:00:00Z"
}

Boas práticas

  • Anexe NF-e/contrato/comprovante de entrega sempre que possível
  • Inclua prints de logs (IP, user-agent, geolocalização do checkout) para casos de fraude
  • Documente o relacionamento prévio com o pagador (e-mails, mensagens) — fortalece defesa
  • Responda dentro de 24h sempre que possível — mesmo com prazo de 7 dias, respostas rápidas têm mais peso na análise

Esta página foi útil?