Developers
توثيق المنتج
العودة للمرجع
POST/transfers
Transfers

تحويل بين المحافظ

ينقل الأموال بين محفظتين مع رسم اختياري.

مستوى الوصولcustomer_or_businessالحد20/minمنع التكرارbody:idempotency_keyالمصادقةBearerAuth
المصدرLuxApi/app/Http/Controllers/Api/WalletApiController.php::transferLuxPayProjects @ 146e98baa44e

المعاملات

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

Client correlation identifier. LuxPay may generate one when omitted.

Example: req_01J...

جسم الطلب

TransferRequestإلزامي
source_wallet_id
integer
Example: 42
destination_wallet_id
integer
Example: 87
amount
number
Example: 1250.5
currency_code
string
Example: YER
idempotency_key
string
Example: transfer_01JABC...
transfer_type
string
fee_amount
number
description
string | null

JSON example

{
  "source_wallet_id": 42,
  "destination_wallet_id": 87,
  "amount": 1250.5,
  "currency_code": "YER",
  "idempotency_key": "transfer_01JABC...",
  "transfer_type": "wallet_to_wallet",
  "fee_amount": 0,
  "description": "string"
}

أمثلة الكود

العنوان المعروض Sandbox Placeholder حتى يتم تزويد النطاق الرسمي. لا تلصق رمز Production في متصفح عام.
curl --request POST \
  --url 'https://sandbox-api.luxpay.example/v1/transfers' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "source_wallet_id": 42,
  "destination_wallet_id": 87,
  "amount": 1250.5,
  "currency_code": "YER",
  "idempotency_key": "transfer_01JABC...",
  "transfer_type": "wallet_to_wallet",
  "fee_amount": 0,
  "description": "string"
}'

الاستجابات

200Successful response.
status
boolean
Example: true
message
string | null
data
Transfer
{
  "status": true,
  "message": "string",
  "data": {
    "uuid": "00000000-0000-4000-8000-000000000001",
    "source_wallet_id": 1,
    "destination_wallet_id": 1,
    "amount": 1,
    "currency_code": "string",
    "fee_amount": 1,
    "status": "string",
    "idempotency_key": "string"
  }
}
400
401
403
404
409
422
429
500
OpenAPI JSONOpenAPI YAMLPostman collection