Geri ödemek

post

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

Kopya

Rica etmek

Sorgu parametreleri

İsim	Parametre türü	Tanım
address*	string	Geri ödemenin yapılması gereken adres
is_subtract*	boolean	Tüccarın bakiyesinden veya geri ödeme tutarından bir komisyon alıp alacağı true - Komisyonu Satıcı Dengesi'nden alın false - İade edilebilir tutarı komisyon tutarına göre azaltın
uuid*	uuidrequired_without: order_id	Fatura uuid
order_id*	stringmin:1max:128alpha_dashrequired_without: uuid	Fatura Siparişi Kimliği

Parametre türü

string

Tanım

Geri ödemenin yapılması gereken adres

Parametre türü

boolean

Tanım

Tüccarın bakiyesinden veya geri ödeme tutarından bir komisyon alıp alacağı true - Komisyonu Satıcı Dengesi'nden alın false - İade edilebilir tutarı komisyon tutarına göre azaltın

Parametre türü

uuidrequired_without: order_id

Tanım

Fatura uuid

Parametre türü

stringmin:1max:128alpha_dashrequired_without: uuid

Tanım

Fatura Siparişi Kimliği

* - zorunlu parametre

Fatura tarafından tanımlanır order_id veya uuid, her ikisini de geçerseniz, hesap UUID tarafından tanımlanacaktır.

Talep Örneği


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

Kopya

Cevap

Yanıt örneği


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

Kopya

Olası hatalar

Doğrulama hataları

kodlamak : 422

Örnek Yanıtlar:

Sağladığınız uuid veya order_id ile fatura mevcut değilse:


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

Kopya

Bir uuid ve order_id geçmeyecekseniz, bu mesajı alacaksınız. Bu, parametrelerden en az birinin gerekli olduğu anlamına gelir.


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

Kopya

Satıcılarınızda ödemeler engellenirse, bu hata mesajını alırsınız. Bu, örneğin, şifrenizi değiştirdiğinizde ve ödemeler 24 saat boyunca engellendiğinde olur.


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

Kopya

Bir faturaya bağlı satıcı cüzdanı yoksa:


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

Kopya

Fatura sonlandırılmamış veya ödenmezse.


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

Kopya

İade edilecek tutar fatura ödemesinin tutarını aşarsa:


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

Kopya

Teknik çalışma gerçekleşir ve ödeme geçici olarak kullanılamazsa, bu hata mesajını alabilirsiniz:


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

Kopya