العودة للمرجع
POST/payments/{paymentUuid}/confirm
Payments

تأكيد عملية دفع

يؤكد عملية دفع مبدوءة ويقبل بيانات تأكيد اختيارية.

مستوى الوصولauthenticatedالحدpay_apiمنع التكرارheader:Idempotency-KeyالمصادقةBearerAuth
المصدرLuxApi/Modules/PayAPI/Controllers/PaymentController.php::confirmLuxPayProjects @ 146e98baa44e

المعاملات

X-Request-IDheader
stringاختياري

Client correlation identifier. LuxPay may generate one when omitted.

Example: req_01J...
paymentUuidpath
stringإلزامي

Payment UUID.

Example: cf1b7e8e-5bba-4ddb-b2e4-6f4a10d24857
Idempotency-Keyheader
stringإلزامي

Unique key for safely retrying this mutation. Reuse only for the same logical request.

Example: pay_01JABC...

جسم الطلب

ConfirmPaymentRequestإلزامي
metadata
object | null

JSON example

{
  "metadata": {}
}

أمثلة الكود

العنوان المعروض Sandbox Placeholder حتى يتم تزويد النطاق الرسمي. لا تلصق رمز Production في متصفح عام.
curl --request POST \
  --url 'https://sandbox-api.luxpay.example/v1/payments/cf1b7e8e-5bba-4ddb-b2e4-6f4a10d24857/confirm' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <token>' \
  --header 'Idempotency-Key: pay_01JABC...' \
  --header 'Content-Type: application/json' \
  --data '{
  "metadata": {}
}'

الاستجابات

200Successful response.
success
boolean
Example: true
data
PaymentResult
{
  "success": true,
  "data": {
    "success": false,
    "transaction_id": "string",
    "status": "string",
    "provider": "string",
    "provider_ref": "string",
    "amount": 1,
    "currency": "string",
    "fee_amount": 1,
    "net_amount": 1,
    "message": "string",
    "error_code": "string",
    "is_duplicate": false,
    "metadata": {}
  }
}
400
401
403
404
409
422
429
500
OpenAPI JSONOpenAPI YAMLPostman collection