PayZu PaymentsCotações
Converter um valor para outra moeda
GET/currencies/{code}/convert
Confira o passo a passo → https://docs.payzu.com.br/docs/payments/convert-an-amount
Requisições recentes
A conversão usa a cotação do último fechamento do Banco Central.
Path Params
codestring enumobrigatório
Código ISO 4217 da moeda de destino.
Query Params
amountintegerobrigatório
Valor a converter, em centavos de real.
typestring enumobrigatório
Usa a taxa de compra (bid) ou a de venda (ask).
bidaskHeaders
Authorizationstringobrigatório
Bearer seguido do token de API.
acceptstring
Formato da resposta.
Responses
200Valor convertido
amountnumberValor convertido, em centavos da moeda de destino.
currencyobjectMoeda de destino e cotação usada.
Campos do objeto 2
codestringCódigo ISO 4217 da moeda.
rateobjectCotação usada na conversão.
Campos do objeto 2
bidnumberTaxa de compra, em reais por unidade da moeda.
asknumberTaxa de venda, em reais por unidade da moeda.
400Requisição inválida
statusCodeintegerStatus HTTP.
errorstringNome do status HTTP.
messagestringMotivo em texto.
codestringCódigo do erro, PZ mais três dígitos; ausente nos erros de autenticação, de cotação e do servidor HTTP.
detailsarray of objectsDetalhes do erro: em 400, os campos recusados; em 422, a recusa original do cartão.
Campos de cada item 2
fieldstringCampo recusado.
messagestringMotivo da recusa.
401Token ou certificado inválido
statusCodeintegerStatus HTTP.
errorstringNome do status HTTP.
messagestringMotivo em texto.
403Acesso negado
statusCodeintegerStatus HTTP.
errorstringNome do status HTTP.
messagestringMotivo em texto.
422Moeda sem cotação
statusCodeintegerStatus HTTP.
errorstringNome do status HTTP.
messagestringMotivo em texto.
500Erro interno
statusCodeintegerStatus HTTP.
errorstringNome do status HTTP.
messagestringMotivo em texto.
codestringCódigo do erro, PZ mais três dígitos; ausente nos erros de autenticação, de cotação e do servidor HTTP.
requestIdstringID da chamada, para o suporte; só em 5xx.
Esta página ajudou?