Pular para o conteúdo

↑↓ navegar ↵ abrir Ctrl↵ nova aba esc fechar

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.

DELETE https://api.rapidchargeback.com/api/v1/merchants/:merchant_id
Authorization: Basic base64(client_id:client_secret)

ParamTipoDescrição
merchant_idstring (UUID)O id do merchant

Janela do terminal
curl -X DELETE https://api.rapidchargeback.com/api/v1/merchants/00000000-0000-0000-0000-000000000001 \
-H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="

HTTP/1.1 204 No Content

Sem corpo.

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).

HTTPCódigoQuando
404MERCHANT_NOT_FOUNDO merchant não existe, é de outra empresa, ou o id não é um UUID
409MERCHANT_HAS_HISTORYO merchant tem dado ligado
403KYB_NOT_APPROVED, COMPANY_NOT_ACTIVE, COMPANY_BLOCKEDEmpresa sem cadastro aprovado, inativa ou bloqueada
429RATE_LIMIT_EXCEEDEDMais de 60 escritas por minuto
503SERVICE_UNAVAILABLEIndisponibilidade temporária: repita depois do Retry-After

  • Repetir depois de um 503: se o merchant já tinha sido apagado, a nova chamada responde 404 MERCHANT_NOT_FOUND.
  • Atividade: a remoção aparece na Atividade do painel como feita pela integração.