रिफंड बनाएँ

एक कैप्चर किए गए शुल्क के लिए रिफंड जारी करता है। आप एक कस्टम रिफंड राशि निर्दिष्ट कर सकते हैं या पूर्ण शेष राशि लौटाने के लिए इसे छोड़ सकते हैं। Stripe मूल मुद्रा में रिफंड जारी करता है और उन्हें सीधे ग्राहक के प्रारंभिक भुगतान तरीके में भेजता है।

आप किसी चार्ज को उसके प्रारंभिक शेष से अधिक रिफंड नहीं कर सकते। यदि आप पहले से निपटाए गए चार्ज को रिफंड करने का प्रयास करते हैं या मूल कुल राशि से अधिक रिफंड करते हैं, तो Stripe एक त्रुटि लौटाता है।

POST https://api.stripe.com/v1/refunds

उदाहरण

cURL उदाहरण:

cURL

curl -X POST https://api.stripe.com/v1/refunds \
  -u <YOUR_SECRET_KEY>: \
  -d "charge=ch_1NirD82eZvKYlo2CIvbtLWuY"

प्रतिक्रियाएँ

प्रतिक्रियाएँ मानक कोड लौटाती हैं।

200: OK

प्रतिक्रिया

{
  "id": "re_1Nispe2eZvKYlo2Cd31jOCgZ",
  "object": "refund",
  "amount": 212,
  "balance_transaction": "txn_1Nispe2eZvKYlo2CYezqFhEx",
  "charge": "ch_1NirD82eZvKYlo2CIvbtLWuY",
  "created": 1692942318,
  "currency": "usd",
  "destination_details": {
    "card": {
      "reference": "123456789012",
      "reference_status": "available",
      "reference_type": "acquirer_reference_number",
      "type": "refund"
    },
    "type": "card"
  },
  "metadata": {},
  "payment_intent": "pi_1GszsK2eZvKYlo2CfhZyoZLp",
  "reason": null,
  "receipt_number": null,
  "source_transfer_reversal": null,
  "status": "succeeded",
  "transfer_reversal": null
}

त्रुटि प्रतिक्रियाएँ

400: Bad Request

प्रतिक्रिया

{
  "error": {
    "code": "parameter_invalid_integer",
    "doc_url": "https://stripe.com/docs/error-codes/parameter-invalid-integer",
    "message": "Invalid integer: <integer>",
    "param": "amount",
    "request_log_url": "https://dashboard.stripe.com/test/logs/req_UQf6XBwBl9yk66?t=1734829676",
    "type": "invalid_request_error"
  }
}

401: Unauthorized

प्रतिक्रिया

{
  "error": {
    "type": "invalid_request_error",
    "message": "Invalid API Key provided: sk_test_********************1234"
  }
}

पैरामीटर

बॉडी पैरामीटर

पैरामीटर	प्रकार	विवरण
amount	पूर्णांक	रिफंड राशि सेंट में। यदि छोड़ा जाए, तो Stripe पूरी चार्ज राशि वापस कर देता है।
charge	स्ट्रिंग	(आवश्यक) रिफंड किए जाने वाले चार्ज की आईडी।
currency	स्ट्रिंग	तीन-अक्षर का ISO मुद्रा कोड, छोटे अक्षरों में। यह एक समर्थित मुद्रा होनी चाहिए। यदि छोड़ा जाए, तो Stripe मूल चार्ज की मुद्रा अपना लेता है।
expand[]	स्ट्रिंग्स की सरणी	इनलाइन समृद्ध करने और लौटाने के लिए नेस्टेड प्रतिक्रिया ऑब्जेक्ट्स की पहचान करता है।
customer	स्ट्रिंग	जिस ग्राहक का यह शुल्क है, उसकी आईडी।
reason	स्ट्रिंग	रिफंड का कारण। यदि सेट किया गया हो, तो संभावित मान हैं duplicate, fraudulent, या requested_by_customer। यदि इसे fraudulent पर सेट किया गया हो, तो Stripe संबंधित कार्ड और ईमेल को आपकी ब्लॉक सूचियों में जोड़ देता है। इससे धोखाधड़ी का पता लगाने में मदद मिलती है।
payment_intent	स्ट्रिंग	रिफंड करने के लिए PaymentIntent की आईडी।
refund_application_fee	बूलियन	यह निर्धारित करता है कि Stripe प्लेटफ़ॉर्म शुल्क को खाते में वापस जमा करता है या नहीं। पूर्ण रिफंड के लिए, Stripe संपूर्ण शुल्क वापस करता है। आंशिक रिफंड के लिए, Stripe पुनः गणना करके एक आनुपातिक राशि वापस करता है। प्लेटफ़ॉर्म शुल्क केवल उस प्लेटफ़ॉर्म पर लागू होता है जिसने चार्ज बनाया था।
origin	स्ट्रिंग	रिफंड का स्रोत।
reverse_transfer	बूलियन	यह निर्धारित करता है कि Stripe जुड़े खाते से हस्तांतरित धनराशि वापस लेगा या नहीं। Stripe रिफंड की गई राशि (पूर्ण या आंशिक रिफंड) के अनुपात में जुड़े ट्रांसफर को उलट देता है।
instructions_email	स्ट्रिंग	यदि ग्राहक के भुगतान विधि में अंतर्निहित रिफंड समर्थन नहीं है, तो यह ईमेल पते पर मैनुअल भुगतान निर्देश भेजता है।