POST/api/public/access-request/paypal/capture-order

Captured (بهطور نهایی ثبت میکند) سفارشی را که قبلاً ایجاد شده و توسط خریدار در PayPal-Checkout تأیید شده است. سمت سرور معتبر است — کلاینت نمیتواند هیچ مبلغی را تحت تأثیر قرار دهد.

Auth & Absicherung

Keine Authentifizierung erforderlich

strictLimiter (10 Req/15min, مقید به IP).

Idempotent: Nein

Parameter

order_id(body, string, erforderlich)— شناسه سفارش PayPal که توسط paypal/create-order ارائه شده است

Beispiel-Request

{"order_id":"<PAYPAL_ORDER_ID>"}

Beispiel-Response

{"ok":false,"error":"UNKNOWN_ORDER","message":"سفارش ناشناخته."}

Fehlercodes

400 ORDER_ID_REQUIRED — order_id موجود نیست.
404 UNKNOWN_ORDER — order_id یک سفارش شناخته‌شده و قبلاً ایجاد شده نیست.
409 CAPTURE_NOT_COMPLETED — پرداخت هنوز توسط خریدار آزاد نشده است.
502 PAYPAL_CAPTURE_FAILED — خطا در ارتباط با پی‌پال.

Live-Test-Nachweis

هر دو مورد منفی بدون پیکربندی PayPal به‌صورت زنده تأیید شدند (400 ORDER_ID_REQUIRED، 404 UNKNOWN_ORDER). یک مورد موفقیت واقعی مستلزم یک فرآیند پرداخت واقعی PayPal Sandbox با تأیید خریدار خواهد بود که طبق مشخصات آزمون حذف شده بود (بدون فراخوانی واقعی ارائه‌دهنده پرداخت).

← فرمهای عمومی