Criando uma fatura

Solicitar

Parâmetros de consulta

* - parâmetro obrigatório

Estrutura de Moedas

* - parâmetro obrigatório

Estrutura de except_currencies

* - parâmetro obrigatório

Exemplo de solicitação

Abaixo está um exemplo de amostra com o número mínimo necessário de parâmetros. Nesse caso, uma fatura será criada com o USD da moeda fiduciária. Na página de pagamento, o usuário poderá selecionar a criptomoeda e a rede para pagar esta conta.

curl https://api.cryptomus.com/v1/payment \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
	"amount": "15",
	"currency": "USD",
	"order_id": "1"
}'

Resposta

Parâmetros de resposta

Exemplo de resposta

1{
2	"state": 0,
3	"result": {
4		"uuid": "26109ba0-b05b-4ee0-93d1-fd62c822ce95",
5		"order_id": "1",
6		"amount": "15.00",
7		"payment_amount": null,
8		"payer_amount": null,
9		"discount_percent": null,
10		"discount": "0.00000000",
11		"payer_currency": null,
12		"currency": "USD",
13		"merchant_amount": null,
14		"network": null,
15		"address": null,
16		"from": null,
17		"txid": null,
18		"payment_status": "check",
19		"url": "https://pay.cryptomus.com/pay/26109ba0-b05b-4ee0-93d1-fd62c822ce95",
20		"expired_at": 1689098133,
21		"status": "check",
22		"is_final": false,
23		"additional_data": null,
24		"created_at": "2023-07-11T20:23:52+03:00",
25		"updated_at": "2023-07-11T21:24:17+03:00"
26	}
27}

Mais exemplos

Solicite dados para criar uma fatura para 20 USDT na rede Tron. A fatura terá um endereço no momento da criação.

1{
2	"amount": "20",
3	"currency": "USDT",
4	"order_id": "1",
5	"network": "tron"
6}

Solicite dados para criar uma fatura para 25 dólares e permitir que os clientes paguem apenas pelo USDT em qualquer rede.

1{
2	"amount": "25",
3	"currency": "USD",
4	"order_id": "1",
5	"to_currency": "USDT"
6}

Solicite dados para criar uma fatura para 25 dólares e permitir que os clientes paguem apenas pelo USDT na rede Tron. A fatura terá um endereço no momento da criação.

1{
2	"amount": "25",
3	"currency": "USD",
4	"order_id": "1",
5	"to_currency": "USDT",
6	"network": "tron"
7}

Solicite dados para criar uma fatura para 20 USDT e permitir que os clientes paguem em todas as redes disponíveis

1{
2	"amount": "20",
3	"currency": "USDT",
4	"order_id": "1"
5}

Solicite dados para criar uma fatura para 20 dólares e permitir que os clientes paguem apenas no Bitcoin. A fatura terá um endereço no momento da criação.

1{
2	"amount": "20",
3	"currency": "USD",
4	"order_id": "1",
5	"to_currency": "BTC"
6}

Solicite dados para criar uma fatura para 0,5 BTC e permitir que os clientes paguem apenas no Bitcoin. A fatura terá um endereço no momento da criação.

1{
2	"amount": "0.5",
3	"currency": "BTC",
4	"order_id": "1"
5}

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		"amount": ["validation.required"]
5	}
6}

Se você forneceu o código de rede que não é suportado

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

Se não suportarmos o código da moeda que você forneceu no parâmetro currency:

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

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}

Se não encontrarmos o serviço de pagamento da moeda que foi aprovada no parâmetro to_currency :

1{
2    "state": 1,
3    "message": "Not found service to_currency"
4}

Se acidentalmente acontecer, algo acontecer ao converter para to_currency :

1{
2    "state": 1,
3    "message": "Error convert to_currency"
4}

Se o valor do pagamento for menor que o valor mínimo suportado para criptomoeda, você receberá esta mensagem de erro:

1{
2    "state": 1,
3    "message": "Minimum amount 0.5 USDT"
4}

Se o valor do pagamento for maior que o valor máximo suportado para criptomoeda, você receberá esta mensagem de erro:

1{
2    "state": 1,
3    "message": "Maximum amount 10000000 USDT"
4}

Se você não tiver uma carteira de comerciante ativa com uma criptomoeda do pagamento, receberá este erro:

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

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

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

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

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

Erro do Servidor Interno

código : 500

Exemplo de respostas:

1{
2	"message": "Server error, #1",
3	"code": 500,
4	"error": null
5}