Remover Owner Detail

Descrição: Remove (soft delete) um registro de owner detail.

Endpoint indisponível. Na versão atual da API este endpoint sempre responde 500 Internal Server Error e a remoção não é efetivada — a instrução de remoção lógica referencia uma coluna que não existe na tabela, e a operação falha antes de gravar qualquer alteração. Não há chamada bem-sucedida possível hoje, e não existe parâmetro ou header que contorne o problema.

Enquanto isso não for corrigido: para deixar de usar um segredo HMAC, troque-o via PUT /api/v1/integration/owner-details/{id}; para remover o registro, acione o suporte em support-api@merx.tech.

O header Content-Type: application/json é obrigatório, mesmo sem corpo na requisição. Sem ele a API responde 415 Unsupported Media Type, sem corpo — antes mesmo de chegar à falha descrita acima.

Endpoint

DELETE/api/v1/integration/owner-details/{id}

Regras

Atributos	Descrição	Tipo	Obrigatório	Validações
id	Identificador do owner detail	UUID	Sim	-

Exemplo de Requisição

cURL

curl -X DELETE \
  -H "Authorization: {SUA_API_KEY}" \
  -H "Content-Type: application/json" \
  "https://api.merx.tech/api/v1/integration/owner-details/{id}"

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.merx.tech/api/v1/integration/owner-details/{id}"))
    .header("Authorization", "{SUA_API_KEY}")
    .header("Content-Type", "application/json")
    .DELETE()
    .build();

HttpClient client = HttpClient.newHttpClient();
try {
    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.statusCode());
} catch (Exception e) {
    e.printStackTrace();
}

JavaScript

const response = await fetch(
  'https://api.merx.tech/api/v1/integration/owner-details/{id}',
  {
    method: 'DELETE',
    headers: {
      'Authorization': '{SUA_API_KEY}',
      'Content-Type': 'application/json',
    },
  }
);
console.log(response.status);

Python

import requests

url = "https://api.merx.tech/api/v1/integration/owner-details/{id}"

headers = {
    "Authorization": "{SUA_API_KEY}",
    "Content-Type": "application/json"
}

response = requests.delete(url, headers=headers)
print(response.status_code)

SDK Java

import com.merx.sdk.api.MerxClient;
import com.merx.sdk.core.Environment;
import java.util.UUID;

MerxClient merx = MerxClient.builder()
    .apiKey("{SUA_API_KEY}")
    .environment(Environment.SANDBOX)
    .build();

merx.ownerDetails().delete(UUID.fromString("00000000-0000-0000-0000-000000000000"));

Parâmetros

Parâmetros de Caminho:

Nome	Descrição	Tipo	Obrigatório
id	Identificador do owner detail	String	Sim

Parâmetros de Cabeçalho

Nome	Descrição	Tipo	Obrigatório
Authorization	Chave de API obtida via support-api@merx.tech	String	Sim
Content-Type	application/json — exigido mesmo sem corpo; ausente ou incorreto resulta em 415 sem corpo	String	Sim

Respostas

• 500 - Internal Server Error

Resposta de todas as chamadas a este endpoint na versão atual da API. A remoção não é efetivada e o owner detail permanece ativo, com o mesmo hmac_secret.

{
  "messages": ["mensagem interna do erro"]
}

• 401 - Unauthorized

Devolvido pelo gateway quando o Authorization está ausente ou inválido — nesse caso a resposta traz corpo, no formato {"data": [], "error": {...}}. A mensagem dentro de error varia conforme o plugin de autenticação da rota, então não programe em cima do texto.

• 415 - Unsupported Media Type

Sem corpo. Devolvido quando o header Content-Type: application/json não é enviado.

Não há hoje resposta de sucesso (204) nem 404 neste endpoint.