Erstattung

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

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

Kopie

Antwort

Antwortbeispiel


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

Kopie

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}

Kopie

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}

Kopie

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

Kopie

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


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

Kopie

Wenn die Rechnung nicht abgeschlossen ist oder nicht bezahlt wird.


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

Kopie

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}

Kopie

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}

Kopie