البحث عن نوايا الدفع

باستخدام لغة استعلامات البحث الخاصة بـ Stripe، يمكنك البحث عن نوايا الدفع التي تم إنشاؤها مسبقًا.

تجنب استعلامات البحث في مسارات "القراءة بعد الكتابة" التي تتطلب اتساقًا فوريًا للبيانات. في ظل التشغيل العادي، يمكن البحث عن البيانات لمدة تقل عن دقيقة واحدة. في بعض الأحيان، قد يتأخر انتشار البيانات الجديدة أو المحدثة لمدة تصل إلى ساعة واحدة أثناء فترات انقطاع الخدمة.

ملاحظة

وظيفة البحث غير متاحة للتجار في الهند.

GET https://api.stripe.com/v1/payment_intents/search

أمثلة

مثال على cURL:

cURL

curl -X GET "https://api.stripe.com/v1/payment_intents/search?query=amount:1000" \
  -u <YOUR_SECRET_KEY>:

الردود

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

200: OK

Response

{
  "object": "search_result",
  "data": [],
  "has_more": false,
  "url": "/v1/payment_intents/search"
}

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

400: Bad Request

Response

{
  "error": {
    "code": "parameter_invalid_string",
    "doc_url": "https://stripe.com/docs/error-codes/parameter-invalid-string",
    "message": "Provide a query parameter with a valid search query string.",
    "param": "query",
    "type": "invalid_request_error"
  }
}

401: Unauthorized

Response

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

المعلمات

معلمات الاستعلام

المعلمة	النوع	الوصف
expand[]	مصفوفة سلاسل نصية	يحدد كائنات الاستجابة المتداخلة لإثرائها وإرجاعها بشكل مضمن.
limit	عدد صحيح	يحدد الحد الأقصى لعدد السجلات في الاستجابة. أدخل عددًا صحيحًا من 1 إلى 100 (القيمة الافتراضية: 10).
page	سلسلة نصية	مؤشر للتنقل بين صفحات النتائج المتعددة. لا تقم بتضمين هذه المعلمة في الاستدعاء الأول. استخدم قيمة next_page التي تم إرجاعها في استجابة سابقة لطلب النتائج التالية.
query	سلسلة نصية	(مطلوب) سلسلة استعلام البحث. راجع لغة استعلامات البحث وقائمة حقول الاستعلام المدعومة لنوايا الدفع.