Chave Pública do Cartão

Retorna a chave pública RSA do cliente autenticado, usada para criptografar dados sensíveis do cartão no frontend.

Obter Chave Pública RSA

curl --request GET \
  --url 'https://api.enoqpay.com.br/gateway/v1/cards/public-key' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json'

Retorno (200)

{
  "key": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA..."
}

Dicionário de dados

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.

Fluxo de Uso

1. Solicitação: O cliente autenticado solicita /v1/cards/public-key
2. Geração/Recuperação: O sistema gera (ou recupera) a chave privada RSA vinculada ao cliente
3. Retorno: A chave pública correspondente é retornada para uso na criptografia dos dados do cartão

A chave pública deve ser usada para criptografar os dados do cartão antes de enviá-los para as rotas de pagamento:

• Pagamento com Antifraude — POST /v1/payments
• Pagamento com 3DS — POST /v1/payments/3ds
• Validar Pagamento 3DS — POST /v1/payments/3ds/validate-v2