Enviar o 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.
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"
}'import { readFileSync } from 'node:fs'
import { Agent } from 'undici'
const agent = new Agent({
connect: {
cert: readFileSync(process.env.PAYZU_CLIENT_CERT),
key: readFileSync(process.env.PAYZU_CLIENT_KEY),
},
})
const basic = Buffer.from(`${process.env.PAYZU_CLIENT_ID}:${process.env.PAYZU_CLIENT_SECRET}`).toString('base64')
const response = await fetch('https://api.sandbox.payzu.dev/v1/token', {
method: 'POST',
dispatcher: agent,
headers: {
Authorization: `Basic ${basic}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ grant_type: 'client_credentials' }),
})
const { access_token } = await response.json(){
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"token_type": "bearer",
"expires_in": 3600
}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.
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"{
"code": "USD",
"rate": {
"bid": 5.42,
"ask": 5.43
}
}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:
| Onde | O que sai |
|---|---|
| cURL | --cert e --key |
| Node.js | O Agent, com a leitura dos arquivos PEM, e o dispatcher |