PayZu CâmbioCarteiras

Criar carteira

POST/v1/wallets

Confira o passo a passo → https://docs.payzu.com.br/docs/fx/register-a-wallet


Body Params

labelstringobrigatório
Nome da carteira.
addressstringobrigatório
Endereço da carteira na rede escolhida.
networkstring enumobrigatório
Rede da carteira.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

200Carteira já cadastrada
idstringID da carteira.
labelstringNome da carteira.
networkstringRede da carteira.
TRC20ERC20BEP20
addressstringEndereço da carteira.
createdAtstringData e hora do cadastro.
201Carteira cadastrada
idstringID da carteira.
labelstringNome da carteira.
networkstringRede da carteira.
TRC20ERC20BEP20
addressstringEndereço da carteira.
createdAtstringData e hora do cadastro.
400Requisição inválida
errorobjectDados do erro.
Campos do objeto 4
codestringCódigo do erro.
invalid_requestinvalid_jsoninvalid_addressinvalid_checksuminvalid_labelidempotency_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_scopeaccount_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.
address_existslabel_existsaddress_limitidempotency_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.
idempotency_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/wallets \     --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