Criando uma carteira estática

post

https://api.cryptomus.com/v1/wallet

CÓPIA DE

Solicitar

Parâmetros de consulta

Nome	Tipo de parâmetro	Valor padrão	Definição
currency*	string		Código da moeda
network*	string		Código de rede blockchain
order_id*	stringmin: 1max: 100alpha_dash		Pedido ID em seu sistemaO parâmetro deve ser uma sequência que consiste em caracteres alfabéticos, números, sublinhados e traços. Não deve conter espaços ou caracteres especiais.O order_id deve ser único nas faturas do comerciante/carteiras estáticas/pagamentos de recorrênciaQuando encontramos uma fatura existente com order_id , retornamos seus detalhes, uma nova fatura não será criada.
url_callback	stringmin: 6max: 255url	null	URL, para o qual o webhook será enviado após cada recarga da carteira
from_referral_code	string	null	O comerciante que faz a solicitação se conecta a um referenciador por código.Por exemplo, você é um aplicativo que gera faturas através da API Cryptomus e seus clientes são outras lojas. Eles inserem sua chave da API e ID do comerciante em seu aplicativo e você envia solicitações com suas credenciais e passando seu código de referência.Assim, seus clientes se tornam referências na sua conta Cryptomus e você receberá renda de sua rotatividade.

Tipo de parâmetro

string

Definição

Código da moeda

Tipo de parâmetro

string

Definição

Código de rede blockchain

Tipo de parâmetro

stringmin: 1max: 100alpha_dash

Definição

Pedido ID em seu sistemaO parâmetro deve ser uma sequência que consiste em caracteres alfabéticos, números, sublinhados e traços. Não deve conter espaços ou caracteres especiais.O order_id deve ser único nas faturas do comerciante/carteiras estáticas/pagamentos de recorrênciaQuando encontramos uma fatura existente com order_id , retornamos seus detalhes, uma nova fatura não será criada.

Tipo de parâmetro

stringmin: 6max: 255url

Definição

URL, para o qual o webhook será enviado após cada recarga da carteira

Tipo de parâmetro

string

Definição

O comerciante que faz a solicitação se conecta a um referenciador por código.Por exemplo, você é um aplicativo que gera faturas através da API Cryptomus e seus clientes são outras lojas.
Eles inserem sua chave da API e ID do comerciante em seu aplicativo e você envia solicitações com suas credenciais e passando seu código de referência.Assim, seus clientes se tornam referências na sua conta Cryptomus e você receberá renda de sua rotatividade.

* - parâmetro obrigatório

Exemplo de solicitação


curl https://api.cryptomus.com/v1/wallet \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
    "currency": "USDT",
    "network": "tron", 
    "order_id": "1",
    "url_callback": "https://your.site/callback"
}'

CÓPIA DE

Resposta

Parâmetros de resposta

Nome	Definição
wallet_uuid	Uuid da carteira do comerciante
uuid	uuid da carteira em uma determinada rede
address	Endereço da carteira em uma determinada rede
network	Código da rede da carteira
currency	Moeda de rede de carteira
url	Link para formulário de pagamento

: Definição
Uuid da carteira do comerciante
: Definição
uuid da carteira em uma determinada rede
: Definição
Endereço da carteira em uma determinada rede
: Definição
Código da rede da carteira
: Definição
Moeda de rede de carteira
: Definição
Link para formulário de pagamento

Exemplo de resposta


1{
2	"state": 0,
3	"result": {
4		"wallet_uuid": "de15b0f6-883f-4585-b27b-73a648044a92",
5		"uuid": "87961ae5-80c5-413a-a4fe-d38199894940",
6		"address": "TTEtddVZyNtLD9wbq4PzomjBhtxenSMXbb",
7		"network": "tron",
8		"currency": "USDT",
9		"url": "https://pay.cryptomus.com/wallet/3901446a-4b74-4796-b50a-14e14dafe3ed"
10	}
11}

CÓPIA DE

Possíveis erros

Erros de validação

código : 422

Exemplo de respostas:

Se algum parâmetro for necessário e não for passado:


1{
2	"state": 1,
3	"errors": {
4		"currency": ["validation.required"]
5	}
6}

CÓPIA DE

Se seus pagamentos estiverem bloqueados. Nesse caso, você precisa entrar em contato com o suporte.


1{
2    "state": 1,
3    "message": "You are forbidden"
4}
5

CÓPIA DE

Se não encontrarmos o serviço de pagamento com a currency e network:


1{
2    "state": 1,
3    "message": "The service was not found"
4}

CÓPIA DE

Se ocorrer um trabalho técnico e o pagamento estiver temporariamente indisponível, você poderá receber esta mensagem de erro:


1{
2    "state": 1,
3    "message": "The terminal was not found"
4}

CÓPIA DE


1{
2    "state": 1,
3    "message": "Server error"
4}

CÓPIA DE


1{
2    "state": 1,
3    "message": "Wallet not found"
4}

CÓPIA DE