Erstellen einer Rechnung

Anfrage

Abfrageparameter

* - obligatorischer Parameter

Die Struktur von Währungen

* - obligatorischer Parameter

Die Struktur von except_currencies

* - obligatorischer Parameter

Beispiel anfordern

Im Folgenden finden Sie ein Beispielbeispiel mit der minimalen erforderlichen Anzahl von Parametern. In diesem Fall wird eine Rechnung mit dem Fiat -Währung USD erstellt. Auf der Zahlungsseite kann der Benutzer die Kryptowährung und das Netzwerk für die Zahlung dieser Rechnung auswählen.

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

Antwort

Antwortparameter

Antwortbeispiel

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}

Mehr Beispiele

Fordern Sie Daten an, um eine Rechnung für 20 USDT im Tron -Netzwerk zu erstellen. Die Rechnung wird zum Zeitpunkt der Schöpfung eine Adresse haben.

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

Fordern Sie Daten an, um eine Rechnung für 25 USD zu erstellen und Clients zu ermöglichen, nur nach USDT in einem Netzwerk zu bezahlen.

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

Fordern Sie Daten an, um eine Rechnung für 25 USD zu erstellen und Clients nur nach USDT im Tron Network zu bezahlen. Die Rechnung wird zum Zeitpunkt der Schöpfung eine Adresse haben.

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

Fordern Sie Daten an, um eine Rechnung für 20 USDT zu erstellen und Kunden in allen verfügbaren Netzwerken zu bezahlen

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

Fordern Sie Daten an, um eine Rechnung für 20 USD zu erstellen und Kunden nur in Bitcoin zu bezahlen. Die Rechnung wird zum Zeitpunkt der Schöpfung eine Adresse haben.

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

Fordern Sie Daten an, um eine Rechnung für 0,5 BTC zu erstellen und Clients nur in Bitcoin zu bezahlen. Die Rechnung wird zum Zeitpunkt der Schöpfung eine Adresse haben.

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

Mögliche Fehler

Validierungsfehler

Code : 422

Beispielantworten:

Wenn ein Parameter erforderlich ist und nicht übergeben wird:

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

Wenn Sie den nicht unterstützten Netzwerkcode zur Verfügung gestellt haben

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

Wenn wir den Währungscode nicht unterstützen, den Sie in Währung Parameter angegeben haben:

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

Wenn Ihre Zahlungen blockiert sind. In diesem Fall müssen Sie sich an den Support wenden.

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

Wenn wir den Zahlungsdienst der Währung nicht finden, die in to_currency Parameter übergeben wurde:

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

Wenn versehentlich etwas passiert, wenn man in to_currency konvertiert wird:

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

Wenn der Zahlungsbetrag geringer ist als der minimal unterstützte Betrag für die Kryptowährung, erhalten Sie diese Fehlermeldung:

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

Wenn der Zahlungsbetrag größer als der maximal unterstützte Betrag für die Kryptowährung ist, erhalten Sie diese Fehlermeldung:

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

Wenn Sie keine aktive Händler -Brieftasche mit einer Kryptowährung der Zahlung haben, erhalten Sie diesen Fehler:

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

Wenn technische Arbeiten erfolgen und die Zahlung vorübergehend nicht verfügbar ist, können Sie diese Fehlermeldungen erhalten:

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}

Interner Serverfehler

Code : 500

Beispielantworten:

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