Comece aquiSegurança da API

Enviar o certificado


Nesta páginaPeça o tokenChame as demais rotasSem a exigência de certificado

Apresente o certificado e a chave privada na conexão de toda chamada às APIs de cartão, a começar pelo POST /token.

Peça o token

Os exemplos usam as variáveis PAYZU_CLIENT_CERT e PAYZU_CLIENT_KEY com o caminho dos arquivos PEM. O exemplo em Node.js usa o pacote undici; instale com npm install undici.

bash
curl --request POST \
  --url 'https://api.sandbox.payzu.dev/v1/token' \
  --user "$PAYZU_CLIENT_ID:$PAYZU_CLIENT_SECRET" \
  --cert "$PAYZU_CLIENT_CERT" --key "$PAYZU_CLIENT_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "grant_type": "client_credentials"
}'

Referência: Gerar um token de acesso

O fetch nativo do Node.js não recebe certificado direto.

O certificado entra pelo Agent do undici, passado em dispatcher. Em outras linguagens, use a opção de certificado de cliente do seu cliente HTTP; em Python requests, cert=(cert, key).

Chame as demais rotas

Mantenha o mesmo --cert/--key, ou o mesmo dispatcher, e troque o Basic pelo Bearer, como nesta consulta da cotação do dólar.

bash
curl --request GET \
  --url 'https://api.sandbox.payzu.dev/v1/currencies/USD/rate' \
  --header "Authorization: Bearer $PAYZU_TOKEN" \
  --cert "$PAYZU_CLIENT_CERT" --key "$PAYZU_CLIENT_KEY"

Referência: Consultar a cotação de uma moeda

Sem a exigência de certificado

Quando a PayZu desliga a exigência na sua credencial, a chamada muda só nestes pontos:

OndeO que sai
cURL--cert e --key
Node.jsO Agent, com a leitura dos arquivos PEM, e o dispatcher