Erstattung

post

https://api.cryptomus.com/v1/payment/refund

KOPIEREN

Anfrage

Abfrageparameter

Name	Parametertyp	Definition
address*	string	Die Adresse, an die die Rückerstattung vorgenommen werden sollte
is_subtract*	boolean	Ob Sie eine Provision aus dem Guthaben des Händlers oder aus dem Rückerstattungsbetrag nehmen möchten true - Nehmen Sie die Kommission aus dem Händlerbalance aus false - Reduzieren Sie den Rückerstattungsbetrag um den Provisionsbetrag
uuid*	uuidrequired_without: order_id	Rechnung
order_id*	stringmin:1max:128alpha_dashrequired_without: uuid	Rechnungsbestell -ID

Parametertyp

string

Definition

Die Adresse, an die die Rückerstattung vorgenommen werden sollte

Parametertyp

boolean

Definition

Ob Sie eine Provision aus dem Guthaben des Händlers oder aus dem Rückerstattungsbetrag nehmen möchten true - Nehmen Sie die Kommission aus dem Händlerbalance aus false - Reduzieren Sie den Rückerstattungsbetrag um den Provisionsbetrag

Parametertyp

uuidrequired_without: order_id

Definition

Rechnung

Parametertyp

stringmin:1max:128alpha_dashrequired_without: uuid

Definition

Rechnungsbestell -ID

* - obligatorischer Parameter

Rechnung wird durch identifiziert von order_id oder uuidWenn Sie beides bestehen, wird das Konto von UUID identifiziert

Beispiel anfordern


curl https://api.cryptomus.com/v1/payment/refund \
    -X POST \
    -H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
    -H 'sign: fe99035f86fa436181717b302b95bacff1' \
    -H 'Content-Type: application/json' \
    -d '{
            "uuid": "8b03432e-385b-4670-8d06-064591096795",
            "address": "TDD97yguPESTpcrJMqU6h2ozZbibv4Vaqm", 
            "is_subtract": "true"
        }'

KOPIEREN

Antwort

Antwortbeispiel


1{
2  "state": 0,
3  "result": []
4}

KOPIEREN

Mögliche Fehler

Validierungsfehler

Code : 422

Beispielantworten:

Wenn die Rechnung mit dem von Ihnen angegebenen uuid oder order_id nicht vorhanden ist:


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

KOPIEREN

Wenn Sie keine uuid und order_id übergeben, erhalten Sie diese Nachricht. Dies bedeutet, dass mindestens einer der Parameter erforderlich ist.


1{
2	"state": 1,
3	"errors": {
4		"uuid": ["validation.required_without"],
5		"order_id": ["validation.required_without"]
6	}
7}

KOPIEREN

Wenn die Auszahlungen auf Ihrem Händler blockiert sind, erhalten Sie diese Fehlermeldung. Dies geschieht beispielsweise, wenn Sie Ihr Passwort ändern und die Auszahlungen 24 Stunden lang blockiert werden.


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

KOPIEREN

Wenn Händlerbrieftasche, die mit einer Rechnung verbunden ist, nicht vorhanden ist:


1{
2    "state": 1,
3    "message": "Undefined merchant wallet"
4}

KOPIEREN

Wenn die Rechnung nicht abgeschlossen ist oder nicht bezahlt wird.


1{
2    "state": 1,
3    "message": "Refunds are made only for completed payments"
4}

KOPIEREN

Wenn der zurückerstattete Betrag den Betrag der Rechnungszahlung überschreitet:


1{
2    "state": 1,
3    "message": "The refund amount should not be more than the amount paid"
4}

KOPIEREN

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


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

KOPIEREN