PayZu CâmbioCompras

Criar compra

POST/v1/buys

Confira o passo a passo → https://docs.payzu.com.br/docs/fx/confirm-the-buy


Body Params

quoteIdstringobrigatório
ID de uma cotação que ainda não expirou.
networkstring enumobrigatório
Rede do USDT comprado.TRC20ERC20BEP20

Headers

Authorizationstringobrigatório
Bearer seguido do token de API.
Idempotency-Keystringobrigatório
Seu identificador do pedido. Se repetir, retorna a resposta já criada.
acceptstring
Formato da resposta.

Responses

201Compra criada
codestringCódigo da compra.
quoteIdstringID da cotação usada.
networkstring | nullRede do USDT comprado.
TRC20ERC20BEP20
brlAmountstringValor pago.
usdtAmountstringUSDT comprado.
awaitingDeskbooleanIndica se a compra ainda aguarda a liberação do USDT.
createdAtstringData e hora da compra.
400Requisição inválida
errorobjectDados do erro.
Campos do objeto 4
codestringCódigo do erro.
invalid_requestinvalid_jsonidempotency_key_required
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.
404Cotação não encontrada
errorobjectDados do erro.
Campos do objeto 4
codestringCódigo do erro.
not_found
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.
quote_expiredover_availableover_capno_inventoryidempotency_in_progress
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.
rejectedidempotency_key_reused
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_unavailable
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/buys \     --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