Créer une facture

Demande

Paramètres de requête

* - paramètre obligatoire

Structure de Devises

* - paramètre obligatoire

Structure de except_currencies

* - paramètre obligatoire

Demander un exemple

Vous trouverez ci-dessous un exemple d'exemple avec le nombre minimum requis de paramètres. Dans ce cas, une facture sera créée avec la monnaie fiduciaire USD. Sur la page de paiement, l'utilisateur pourra sélectionner la crypto-monnaie et le réseau pour payer cette facture.

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

Réponse

Paramètres de réponse

Exemple de réponse

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		"payment_amount_usd": null,
9		"payer_amount": null,
10		"payer_amount_exchange_rate": null,
11		"discount_percent": null,
12		"discount": "0.00000000",
13		"payer_currency": null,
14		"currency": "USD",
15		"comments": null,
16		"merchant_amount": null,
17		"network": null,
18		"address": null,
19		"from": null,
20		"txid": null,
21		"payment_status": "check",
22		"url": "https://pay.cryptomus.com/pay/26109ba0-b05b-4ee0-93d1-fd62c822ce95",
23		"expired_at": 1689098133,
24		"status": "check",
25		"is_final": false,
26		"additional_data": null,
27		"created_at": "2023-07-11T20:23:52+03:00",
28		"updated_at": "2023-07-11T21:24:17+03:00",
29		"commission": null,
30		"address_qr_code": null
31	}
32}

Plus d'exemples

Demandez des données pour créer une facture pour 20 USDT dans le réseau TRON. La facture aura une adresse au moment de la création.

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

Demandez des données pour créer une facture pour 25 USD et permettez aux clients de payer uniquement par USDT dans n'importe quel réseau.

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

Demandez des données pour créer une facture pour 25 USD et permettez aux clients de payer uniquement par USDT dans TRON Network. La facture aura une adresse au moment de la création.

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

Demander des données pour créer une facture pour 20 USDT et permettre aux clients de payer dans tous les réseaux disponibles

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

Demandez des données pour créer une facture pour 20 USD et permettez aux clients de payer uniquement dans Bitcoin. La facture aura une adresse au moment de la création.

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

Demandez des données pour créer une facture pour 0,5 BTC et permettez aux clients de payer uniquement en Bitcoin. La facture aura une adresse au moment de la création.

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

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

Si vous avez fourni le code réseau qui n'est pas pris en charge

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

Si nous ne prenons pas en charge le code de devise que vous avez fourni dans le paramètre devise :

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

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

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

Si nous ne trouvons pas le service de paiement de la devise qui a été transmis dans le paramètre to_currency :

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

Si accidentellement, quelque chose se produit lors de la convertis en to_currency :

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

Si le montant du paiement est inférieur au montant pris en charge minimum pour la crypto-monnaie, vous recevrez ce message d'erreur:

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

Si le montant du paiement est supérieur au montant maximal pris en charge pour la crypto-monnaie, vous recevrez ce message d'erreur:

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

Si vous n'aurez pas de portefeuille marchand actif avec une crypto-monnaie du paiement, vous recevrez cette erreur:

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

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

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}

Erreur interne du serveur

code : 500

exemples de réponses :

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