API دفع طلب الشراء
POST /v1/orders/pay
جسم الطلب
| الحقل | مطلوب | الوصف |
|---|---|---|
channel | نعم | 1688 | taobao |
order_id | نعم | معرف الطلب الرئيسي من create |
pay_channel | اختياري لـ 1688 | مثل Alipay / kjpayV2 |
الاستجابة
StandardOrderPayResult — نموذج الاستجابة.
تأكيد الدفع واستعادة المحاولة {#recovery-guidance}
يعيد Taobao self القياسي success: true بعد تأكيد الدفع باستعلام الطلب فقط. لا يثبت code: "0" أو نجاح قديم خصم المال. تعني pending نتيجة Gateway غير المؤكدة، لا حالة طابور رسمية.
Idempotency-Key رأس HTTP اختياري. استخدم المفتاح نفسه للمحاولة ذاتها؛ يرسل المفتاح الجديد دفعًا حقيقيًا جديدًا، فلا تنشئه تلقائيًا لتجاوز نتيجة مجهولة.
حقول جديدة اختيارية:
payment_submission_status:submitted/rejected/unknown.payment_recovery:action,reason,elapsed_seconds.
| action | تأكيد الدفع واستعادة المحاولة |
|---|---|
none | لا تدفع مجددًا |
query_order | استعلم عن الطلب أو أعد استخدام المفتاح |
retry_with_new_key | بعد رفض صريح أصلح السبب وتحقق من إمكانية دفع الطلب قبل محاولة جديدة |
manual_review | راجع المدفوعات وحركات الحساب يدويًا؛ لا تعد الدفع تلقائيًا |
بعد 15 دقيقة من المحاولة الأصلية ذات المفتاح: unknown / manual_review / CONFIRMATION_OVERDUE. لا تثبت العتبة الفشل أو انتهاء المهلة، ولا تفتح المفتاح أو تخصم مجددًا. المحاولات القديمة والمنتهية المهلة والعالقة تستعلم فقط وتحفظ التأكيد. قبل مفتاح جديد تأكد يدويًا من انتهاء المحاولة السابقة دون دفع أو خصم. حالة غير مدفوع وحدها غير كافية.
request_id في المحتوى للمحاولة الأصلية؛ رأس x-request-id لطلب HTTP الحالي. أوضاع upstream وsandbox والمستودع لا تتغير. يضيف 1688 الإرشادات عند paySuccess صريح؛ يجب تغيير op_request_id الصريح أيضًا في المحاولة الجديدة.
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days