Creando una billetera estática

post

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

COPIAR

Pedido

Parámetros de consulta

Nombre	Tipo de parámetro	Valor por defecto	Definición
currency*	string		Código de moneda
network*	string		Código de red blockchain
order_id*	stringmin: 1max: 100alpha_dash		ID de pedido en su sistemaEl parámetro debe ser una cadena que consiste en caracteres alfabéticos, números, subrayadores y guiones. No debe contener espacios o caracteres especiales.El Order_id debe ser único dentro de las facturas comerciales/billeteras estáticas/pagos de recurrenciaCuando encontramos una factura existente con order_id , devolvemos sus detalles, no se creará una nueva factura.
url_callback	stringmin: 6max: 255url	null	URL, a la que se enviará el webhook después de cada recarga de la billetera
from_referral_code	string	null	El comerciante que hace la solicitud se conecta a un referente por código.Por ejemplo, usted es una aplicación que genera facturas a través de la API de Cryptomus y sus clientes son otras tiendas. Ingresan su clave API e ID de comerciante en su solicitud, y usted envía solicitudes con sus credenciales y aprobando su código de referencia.Por lo tanto, sus clientes se convierten en referencias en su cuenta de Cryptomus y recibirá ingresos de su facturación.

Tipo de parámetro

string

Definición

Código de moneda

Tipo de parámetro

string

Definición

Código de red blockchain

Tipo de parámetro

stringmin: 1max: 100alpha_dash

Definición

ID de pedido en su sistemaEl parámetro debe ser una cadena que consiste en caracteres alfabéticos, números, subrayadores y guiones. No debe contener espacios o caracteres especiales.El Order_id debe ser único dentro de las facturas comerciales/billeteras estáticas/pagos de recurrenciaCuando encontramos una factura existente con order_id , devolvemos sus detalles, no se creará una nueva factura.

Tipo de parámetro

stringmin: 6max: 255url

Definición

URL, a la que se enviará el webhook después de cada recarga de la billetera

Tipo de parámetro

string

Definición

El comerciante que hace la solicitud se conecta a un referente por código.Por ejemplo, usted es una aplicación que genera facturas a través de la API de Cryptomus y sus clientes son otras tiendas.
Ingresan su clave API e ID de comerciante en su solicitud, y usted envía solicitudes con sus credenciales y aprobando su código de referencia.Por lo tanto, sus clientes se convierten en referencias en su cuenta de Cryptomus y recibirá ingresos de su facturación.

* - parámetro obligatorio

Ejemplo de solicitud


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"
}'

COPIAR

Respuesta

Parámetros de respuesta

Nombre	Definición
wallet_uuid	uuid de la billetera del comerciante
uuid	uuid de la billetera en una red en particular
address	Dirección de billetera en una red en particular
network	Código de red de billetera
currency	Moneda de red de billetera
url	Enlace al formulario de pago

: Definición
uuid de la billetera del comerciante
: Definición
uuid de la billetera en una red en particular
: Definición
Dirección de billetera en una red en particular
: Definición
Código de red de billetera
: Definición
Moneda de red de billetera
: Definición
Enlace al formulario de pago

Ejemplo de respuesta


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}

COPIAR

Posibles errores

Errores de validación

código : 422

Respuestas de ejemplo:

Si se requiere algún parámetro y no se pasa:


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

COPIAR

Si sus pagos están bloqueados. En este caso, debe comunicarse con el soporte.


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

COPIAR

Si no encontramos el servicio de pago con la currency y network :


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

COPIAR

Si se produce un trabajo técnico y el pago no está disponible temporalmente, puede recibir este mensaje de error:


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

COPIAR


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

COPIAR


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

COPIAR