SopagueDocs
v3

Desativar Meio de Pagamento

POST/v2/payment-customers/{customerId}/payment-methods/{paymentMethodId}/deactivate

Inativa o cartão no cofre e no banco de dados. Caso o cartão fosse o padrão, promove automaticamente outro cartão ativo.

Cabeçalhos (Headers)

CabeçalhoValorObrigatórioDescrição
AuthorizationBearer <token>SimToken JWT Bearer autenticado
Idempotency-Key<guid_ou_string>SimChave de idempotência

Parâmetros

Exemplo de requisição
curl --request POST \
  --url 'https://api.sopague.com.br/gateway/v2/payment-customers/{customerId}/payment-methods/{paymentMethodId}/deactivate' \
  --header 'Authorization: Bearer {token}'

Resposta (200 OK)

Exemplo de resposta
{
  "id": "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
  "status": "INACTIVE"
}

Erros

As respostas de erro conhecidas estão abaixo. Os retornos observados em homologação estão identificados separadamente dos exemplos documentados; as respostas podem variar conforme o ambiente e a configuração.

Ver validações observadas em homologação

Requisição com corpo JSON vazio ou identificador sintético. O retorno abaixo mostra a validação realizada em homologação.

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "errors": {
    "Idempotency-Key": [
      "The key field is required."
    ]
  },
  "traceId": "00-bfc1aef735ff2e344020b19c227f0df7-8afec0c311b79e47-00"
}

Campos da resposta de erro

A tabela reúne os campos presentes nos exemplos acima. Uma resposta HTTP sem corpo não inclui esses campos.