Definir Meio de Pagamento Padrão
POST/v2/payment-customers/{customerId}/payment-methods/{paymentMethodId}/default
Define o cartão especificado como o método de pagamento padrão do cliente para cobranças automáticas futuras.
Cabeçalhos (Headers)
| Cabeçalho | Valor | Obrigatório | Descrição |
|---|---|---|---|
Authorization | Bearer <token> | Sim | Token JWT Bearer autenticado |
Idempotency-Key | <guid_ou_string> | Sim | Chave 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}/default' \
--header 'Authorization: Bearer {token}'Resposta (200 OK)
Exemplo de resposta
{
"id": "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
"isDefault": true,
"status": "ACTIVE"
}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-053f5567b4721d28817ae48b394d07ae-20d1a062cd28bcf2-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.
