العودة للمرجع
POST/payment-services/{provider}/select
Payment services

اختيار خدمة الدفع

يقيّم اختيار المزود ويعيد الإجراء التالي للعميل.

مستوى الوصولauthenticatedالحدpay_apiمنع التكرارnoneالمصادقةBearerAuth
المصدرLuxApi/Modules/PayAPI/Controllers/PaymentServiceController.php::selectLuxPayProjects @ 146e98baa44e

المعاملات

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

Client correlation identifier. LuxPay may generate one when omitted.

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

Provider code registered by LuxPay.

Example: wallet

جسم الطلب

PaymentServiceSelectionRequestإلزامي
amount
number | null
currency
string | null
payment_method
string | null
payment_channel
string | null
customer
object | null
metadata
object | null

JSON example

{
  "amount": 1,
  "currency": "string",
  "payment_method": "string",
  "payment_channel": "string",
  "customer": {},
  "metadata": {}
}

أمثلة الكود

العنوان المعروض Sandbox Placeholder حتى يتم تزويد النطاق الرسمي. لا تلصق رمز Production في متصفح عام.
curl --request POST \
  --url 'https://sandbox-api.luxpay.example/v1/payment-services/wallet/select' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 1,
  "currency": "string",
  "payment_method": "string",
  "payment_channel": "string",
  "customer": {},
  "metadata": {}
}'

الاستجابات

200Successful response.
success
boolean
Example: true
data
object
{
  "success": true,
  "data": {
    "service": {
      "provider": "wallet",
      "display_name": "LuxPay Wallet",
      "enabled": true,
      "can_select": true,
      "currencies": [
        "string"
      ],
      "methods": [
        "string"
      ],
      "channels": [
        "string"
      ]
    },
    "next_action": {},
    "trace_id": "string"
  }
}
400
401
403
404
409
422
429
500
OpenAPI JSONOpenAPI YAMLPostman collection