धनवापसी

post
https://api.cryptomus.com/v1/payment/refund
प्रतिलिपि

अनुरोध

क्वेरी पैरामीटर

नामपैरामीटर प्रकारपरिभाषा
address*stringवह पता जहाँ धन वापसी की जानी है
is_subtract*booleanकमीशन व्यापारी के शेष से लिया जाए या रिफंड राशि सेसत्य - व्यापारी शेष से कमीशन लेंगलत - कमीशन राशि से वापसी योग्य राशि कम करें
uuid*uuidrequired_without: order_idइनवॉइस यूयूआईडी
order_id*stringmin:1max:128alpha_dashrequired_without: uuidइनवॉइस ऑर्डर आईडी

पैरामीटर प्रकार

string

परिभाषा

वह पता जहाँ धन वापसी की जानी है

पैरामीटर प्रकार

boolean

परिभाषा

कमीशन व्यापारी के शेष से लिया जाए या रिफंड राशि सेसत्य - व्यापारी शेष से कमीशन लेंगलत - कमीशन राशि से वापसी योग्य राशि कम करें

पैरामीटर प्रकार

uuidrequired_without: order_id

परिभाषा

इनवॉइस यूयूआईडी

पैरामीटर प्रकार

stringmin:1max:128alpha_dashrequired_without: uuid

परिभाषा

इनवॉइस ऑर्डर आईडी

* - अनिवार्य पैरामीटर

चालान की पहचान किसके द्वारा की जाती है? order_id या uuidयदि आप दोनों पास कर लेते हैं, तो खाते की पहचान uuid द्वारा की जाएगी

अनुरोध उदाहरण


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"
        }'
प्रतिलिपि

प्रतिक्रिया

प्रतिक्रिया उदाहरण


1{
2  "state": 0,
3  "result": []
4}
प्रतिलिपि

संभावित त्रुटियाँ

सत्यापन त्रुटियाँ

कोड : 422

उदाहरण प्रतिक्रियाएँ:

यदि आपके द्वारा प्रदान किया गया uuid या order_id वाला इनवॉइस मौजूद नहीं है:


1{
2    "state": 1,
3    "message": "Payment was not found"
4} 
प्रतिलिपि

यदि आप uuid और order_id पास नहीं करेंगे, तो आपको यह संदेश प्राप्त होगा। इसका अर्थ है कि कम से कम एक पैरामीटर आवश्यक है।


1{
2	"state": 1,
3	"errors": {
4		"uuid": ["validation.required_without"],
5		"order_id": ["validation.required_without"]
6	}
7}
प्रतिलिपि

अगर आपके व्यापारी पर भुगतान अवरुद्ध हैं, तो आपको यह त्रुटि संदेश मिलेगा। उदाहरण के लिए, ऐसा तब होता है जब आप अपना पासवर्ड बदलते हैं और भुगतान 24 घंटे के लिए अवरुद्ध हो जाते हैं।


1{
2    "state": 1,
3    "message": "You are forbidden"
4}
5
प्रतिलिपि

यदि किसी इनवॉइस से जुड़ा व्यापारी वॉलेट मौजूद नहीं है:


1{
2    "state": 1,
3    "message": "Undefined merchant wallet"
4}
प्रतिलिपि

यदि चालान अंतिम रूप से तैयार नहीं किया गया है या उसका भुगतान नहीं किया गया है।


1{
2    "state": 1,
3    "message": "Refunds are made only for completed payments"
4}
प्रतिलिपि

यदि वापस की जाने वाली राशि चालान भुगतान की राशि से अधिक है:


1{
2    "state": 1,
3    "message": "The refund amount should not be more than the amount paid"
4}
प्रतिलिपि

यदि तकनीकी कार्य होता है और भुगतान अस्थायी रूप से अनुपलब्ध है, तो आपको यह त्रुटि संदेश प्राप्त हो सकता है:


1{
2    "state": 1,
3    "message": "Server error"
4}
प्रतिलिपि