PayZu CâmbioCompras

Criar cotação de compra

POST/v1/buy-quotes

Confira o passo a passo → https://docs.payzu.com.br/docs/fx/request-a-quote


Body Params

brlAmountstringobrigatório
Valor da compra.

Headers

Authorizationstringobrigatório
Bearer seguido do token de API.
acceptstring
Formato da resposta.

Responses

201Cotação criada
quoteIdstringID da cotação.
brlAmountstringValor da compra.
feeBrlstringTaxa da compra.
usdtAmountstringUSDT que você recebe.
expiresAtstringData e hora em que a cotação expira.
availableBrlstringSaldo em reais disponível para a compra.
400Requisição inválida
errorobjectDados do erro.
Campos do objeto 4
codestringCódigo do erro.
invalid_requestinvalid_jsonamount_out_of_range
requestIdstringInforme este id ao suporte para localizar a chamada.
detailsobjectDados do erro, quando houver.
supportIdstringIdentificador para informar ao suporte, quando houver.
401Chave de API ausente ou inválida
errorobjectDados do erro.
Campos do objeto 4
codestringCódigo do erro.
unauthorizedkey_revokedkey_expired
requestIdstringInforme este id ao suporte para localizar a chamada.
detailsobjectDados do erro, quando houver.
supportIdstringIdentificador para informar ao suporte, quando houver.
403Acesso negado
errorobjectDados do erro.
Campos do objeto 4
codestringCódigo do erro.
api_not_enabledip_not_allowedinsufficient_scopebuy_not_enabledaccount_blocked
requestIdstringInforme este id ao suporte para localizar a chamada.
detailsobjectDados do erro, quando houver.
supportIdstringIdentificador para informar ao suporte, quando houver.
409Conflito
errorobjectDados do erro.
Campos do objeto 4
codestringCódigo do erro.
over_availableover_capno_inventory
requestIdstringInforme este id ao suporte para localizar a chamada.
detailsobjectDados do erro, quando houver.
supportIdstringIdentificador para informar ao suporte, quando houver.
413Corpo grande demais
errorobjectDados do erro.
Campos do objeto 4
codestringCódigo do erro.
payload_too_large
requestIdstringInforme este id ao suporte para localizar a chamada.
detailsobjectDados do erro, quando houver.
supportIdstringIdentificador para informar ao suporte, quando houver.
415Content-Type não aceito
errorobjectDados do erro.
Campos do objeto 4
codestringCódigo do erro.
unsupported_media_type
requestIdstringInforme este id ao suporte para localizar a chamada.
detailsobjectDados do erro, quando houver.
supportIdstringIdentificador para informar ao suporte, quando houver.
422Operação recusada
errorobjectDados do erro.
Campos do objeto 4
codestringCódigo do erro.
cannot_price
requestIdstringInforme este id ao suporte para localizar a chamada.
detailsobjectDados do erro, quando houver.
supportIdstringIdentificador para informar ao suporte, quando houver.
429Limite de requisições atingido
errorobjectDados do erro.
Campos do objeto 4
codestringCódigo do erro.
rate_limited
requestIdstringInforme este id ao suporte para localizar a chamada.
detailsobjectDados do erro, quando houver.
supportIdstringIdentificador para informar ao suporte, quando houver.
500Erro interno
errorobjectDados do erro.
Campos do objeto 4
codestringCódigo do erro.
internal_error
requestIdstringInforme este id ao suporte para localizar a chamada.
detailsobjectDados do erro, quando houver.
supportIdstringIdentificador para informar ao suporte, quando houver.
503Serviço indisponível
errorobjectDados do erro.
Campos do objeto 4
codestringCódigo do erro.
service_unavailableaccount_setting_up
requestIdstringInforme este id ao suporte para localizar a chamada.
detailsobjectDados do erro, quando houver.
supportIdstringIdentificador para informar ao suporte, quando houver.

Linguagem

Credenciais Bearer

Token de API

curl --request POST \     --url https://api.exchange.payzu.com.br/v1/buy-quotes \     --header 'authorization: Bearer SEU_TOKEN' \     --header 'accept: application/json' \     --header 'content-type: application/json' \     --data '{}'
Resposta

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

application/json