Création d'un portefeuille statique

post

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

COPIE

Demande

Paramètres de requête

Nom	Type de paramètre	Valeur par défaut	Définition
currency*	string		Code de devise
network*	string		Code réseau blockchain
order_id*	stringmin: 1max: 100alpha_dash		Commandez ID dans votre systèmeLe paramètre doit être une chaîne composée de caractères alphabétiques, de nombres, de soulignements et de tirets. Il ne doit contenir aucun espace ou caractères spéciaux.Le order_id doit être unique dans les factures marchands / portefeuilles statiques / paiements de récidiveLorsque nous trouvons une facture existante avec order_id , nous retournons ses détails, une nouvelle facture ne sera pas créée.
url_callback	stringmin: 6max: 255url	null	URL, à laquelle le webhook sera envoyé après chaque recharge du portefeuille
from_referral_code	string	null	Le marchand qui fait la demande se connecte à un référent par code.Par exemple, vous êtes une application qui génère des factures via l'API Cryptomus et vos clients sont d'autres magasins. Ils entrent dans leur clé API et leur identifiant de marchand dans votre demande, et vous envoyez des demandes avec leurs informations d'identification et passant votre code de référence.Ainsi, vos clients deviennent des références sur votre compte Cryptomus et vous recevrez des revenus de leur chiffre d'affaires.

Type de paramètre

string

Définition

Code de devise

Type de paramètre

string

Définition

Code réseau blockchain

Type de paramètre

stringmin: 1max: 100alpha_dash

Définition

Commandez ID dans votre systèmeLe paramètre doit être une chaîne composée de caractères alphabétiques, de nombres, de soulignements et de tirets. Il ne doit contenir aucun espace ou caractères spéciaux.Le order_id doit être unique dans les factures marchands / portefeuilles statiques / paiements de récidiveLorsque nous trouvons une facture existante avec order_id , nous retournons ses détails, une nouvelle facture ne sera pas créée.

Type de paramètre

stringmin: 6max: 255url

Définition

URL, à laquelle le webhook sera envoyé après chaque recharge du portefeuille

Type de paramètre

string

Définition

Le marchand qui fait la demande se connecte à un référent par code.Par exemple, vous êtes une application qui génère des factures via l'API Cryptomus et vos clients sont d'autres magasins.
Ils entrent dans leur clé API et leur identifiant de marchand dans votre demande, et vous envoyez des demandes avec leurs informations d'identification et passant votre code de référence.Ainsi, vos clients deviennent des références sur votre compte Cryptomus et vous recevrez des revenus de leur chiffre d'affaires.

* - paramètre obligatoire

Demander un exemple


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

COPIE

Réponse

Paramètres de réponse

Nom	Définition
wallet_uuid	uuid du portefeuille du marchand
uuid	uuid du portefeuille dans un réseau particulier
address	Adresse du portefeuille dans un réseau particulier
network	Code réseau de portefeuille
currency	Currency de réseau de portefeuille
url	Lien vers le formulaire de paiement

: Définition
uuid du portefeuille du marchand
: Définition
uuid du portefeuille dans un réseau particulier
: Définition
Adresse du portefeuille dans un réseau particulier
: Définition
Code réseau de portefeuille
: Définition
Currency de réseau de portefeuille
: Définition
Lien vers le formulaire de paiement

Exemple de réponse


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}

COPIE

Erreurs possibles

Erreurs de validation

code : 422

Exemples de réponses:

Si un paramètre est requis et non passé:


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

COPIE

Si vos paiements sont bloqués. Dans ce cas, vous devez contacter le support.


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

COPIE

Si nous ne trouvons pas le service de paiement avec la currency et network :


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

COPIE

Si le travail technique se produit et que le paiement est temporairement indisponible, vous pouvez recevoir ce message d'erreur:


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

COPIE


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

COPIE


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

COPIE