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


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).bidask

Headers

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.

Linguagem

Credenciais Bearer · mTLS

Token de API

curl --request GET \     --url https://api.sandbox.payzu.dev/v1/currencies/{code}/convert \     --cert cert.pem \     --key key.pem \     --header 'authorization: Bearer SEU_TOKEN' \     --header 'accept: application/json'
Resposta

Clique em Try It! para enviar uma requisição e ver a resposta aqui. Ou escolha um exemplo:

application/json