Remover merchant
Apaga um merchant da sua empresa. Só funciona com merchant sem nenhum dado ligado: nenhuma transação, alerta, evento, disputa, evidência ou enrollment. É para desfazer um cadastro feito por engano.
Merchant com histórico não se apaga. Para marcar que ele saiu, grave status: "inactive" com Editar merchant; para deixar de receber alertas dele, peça a desativação dos enrollments.
Endpoint
Seção intitulada “Endpoint”DELETE
https://api.rapidchargeback.com/api/v1/merchants/:merchant_idAutenticação
Seção intitulada “Autenticação”Authorization: Basic base64(client_id:client_secret)Parâmetros de URL
Seção intitulada “Parâmetros de URL”| Param | Tipo | Descrição |
|---|---|---|
merchant_id | string (UUID) | O id do merchant |
Exemplo de requisição
Seção intitulada “Exemplo de requisição”curl -X DELETE https://api.rapidchargeback.com/api/v1/merchants/00000000-0000-0000-0000-000000000001 \ -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="Resposta
Seção intitulada “Resposta”Apagado
Seção intitulada “Apagado”HTTP/1.1 204 No ContentSem corpo.
Merchant com histórico
Seção intitulada “Merchant com histórico”HTTP/1.1 409 Conflict{ "error": { "code": "MERCHANT_HAS_HISTORY", "message": "Merchant has data (transactions, alerts, events, disputes or enrollments) and cannot be deleted. Set its status to inactive and request deactivation of its enrollments instead" }}Nada foi apagado. Como a mensagem orienta, grave status: "inactive" e peça a desativação dos enrollments (ver acima).
| HTTP | Código | Quando |
|---|---|---|
| 404 | MERCHANT_NOT_FOUND | O merchant não existe, é de outra empresa, ou o id não é um UUID |
| 409 | MERCHANT_HAS_HISTORY | O merchant tem dado ligado |
| 403 | KYB_NOT_APPROVED, COMPANY_NOT_ACTIVE, COMPANY_BLOCKED | Empresa sem cadastro aprovado, inativa ou bloqueada |
| 429 | RATE_LIMIT_EXCEEDED | Mais de 60 escritas por minuto |
| 503 | SERVICE_UNAVAILABLE | Indisponibilidade temporária: repita depois do Retry-After |
- Repetir depois de um
503: se o merchant já tinha sido apagado, a nova chamada responde404 MERCHANT_NOT_FOUND. - Atividade: a remoção aparece na Atividade do painel como feita pela integração.