تحديث عملية استرداد الأموال

تقوم بتحديث خصائص استرداد الأموال المحددة. تحتفظ Stripe بأي معلمات تحذفها من هذا الطلب. وهذا يساعد في تخزين معلومات إضافية حول عملية استرداد الأموال.

POST https://api.stripe.com/v1/refunds/{id}

أمثلة

مثال على cURL:

cURL

curl -X POST https://api.stripe.com/v1/refunds/{id} \
  -u <YOUR_SECRET_KEY>: \
  -d "metadata[order_id]=6735"

الردود

تُرجع الاستجابات رموزًا قياسية.

200: OK

Response

{
  "id": "re_1Nispe2eZvKYlo2Cd31jOCgZ",
  "object": "refund",
  "amount": 1000,
  "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": {
    "order_id": "6735"
  },
  "payment_intent": "pi_1GszsK2eZvKYlo2CfhZyoZLp",
  "reason": null,
  "receipt_number": null,
  "source_transfer_reversal": null,
  "status": "succeeded",
  "transfer_reversal": null
}

استجابات الأخطاء

400: Bad Request

Response

{
  "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

Response

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

المعلمات

معلمات النص الأساسي

المعلمة	النوع	الوصف
metadata	كائن	مجموعة من أزواج القيم والمفاتيح التي يمكنك إرفاقها بكائن ما. ويمكن أن يكون ذلك مفيدًا لتخزين معلومات إضافية عن الكائن بتنسيق منظم.
expand[]	مصفوفة سلاسل نصية	يحدد كائنات الاستجابة المتداخلة لإثرائها وإرجاعها بشكل مضمن.

متغيرات المسار

الاسم	النوع	مطلوب	الوصف
id	سلسلة نصية	مطلوب	معرف عملية الاسترداد المراد تحديثها.