PayZu PaymentsCotações e conversão
Converter um valor
Converta um valor em centavos de real para a moeda de destino, com a cotação do último fechamento.
Converta o valor
| Parâmetro | O que enviar |
|---|---|
amount | Valor em centavos de real. |
type | Lado da cotação: ask ou bid. |
bash
curl --request GET \
--url 'https://api.sandbox.payzu.dev/v1/currencies/USD/convert?amount=10000&type=ask' \
--header "Authorization: Bearer $PAYZU_TOKEN" \
--cert "$PAYZU_CLIENT_CERT" --key "$PAYZU_CLIENT_KEY"json
{
"amount": 1841.62,
"currency": {
"code": "USD",
"rate": {
"ask": 5.43
}
}
}js
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 url = 'https://api.sandbox.payzu.dev/v1/currencies/USD/convert?amount=10000&type=ask'
const response = await fetch(url, {
dispatcher: agent,
headers: { Authorization: `Bearer ${process.env.PAYZU_TOKEN}` },
})
if (!response.ok) throw new Error(`HTTP ${response.status}`)
const quote = await response.json()
const cents = Math.round(quote.amount)
console.log(`R$ 100,00 = US$ ${(cents / 100).toFixed(2)} (ask ${quote.currency.rate.ask})`)Referência: Converter um valor para outra moeda
A resposta vem em centavos da moeda de destino, com duas casas decimais. Com ask, que é a taxa maior, R$ 100,00 viram 1841.62 centavos de dólar, ou US$ 18,42 depois de arredondar; com bid, 1845.02.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
| - | 422 | Cannot get currency rate |
Nos 400 de validação, o campo vem em details[].field. O formato do corpo está em Erros, e os demais códigos, no Catálogo de erros.