كيف يمكن إرسال حوالة من حساب بايبال لآخر عن طريق الواجهة البرمجية؟

يمكن إرسال تفاصيل التحويل إلى الواجهة البرمجية الخاصة ببايبال عبر طلب POST إلى المسار التالي: 

/v1/payments/payouts

الترويسات الواجب إرسالها هي نوع المحتوى Content-Type لوصف نوع المحتوى المرسل، وتروسية التوثيق Authorization كالتالي (مع تبديل المفتاح بالمفتاح الخاص بحسابك):

Content-Type: application/json
Authorization: Bearer <المفتاح الخاص بحسابك>

جسم الطلب هو غرض JSON يتضمن مفتاحين رئيسيين :

• sender_batch_header: وفيه معلومات عن الحوالة الحالية من معرّف خاص تضع فيه أي قيمة تريد، وعنوان ومحتوى البريد الالكتروني المرسل للحساب الوجهة عند استلامه للحوالة

  "sender_batch_header": {
    "sender_batch_id": "1234",
    "email_subject": "تم إرسال أرباحك",
    "email_message": "المبلغ المرسل هو أرباحك خلال المدة الماضية، شكرًا لك"
  }

   

• items: وهي مصفوفة تضم أكثر من حوالة وتفاصيل عم الوجهة يمكنك إرسالها معًا، تتضمن التفاصيل التالية:
  • recipient_type: وهو نوع حساب الوجهة إما لديك عنوان بريده أو رقم هاتفه أو معرّف بايبال الخاص به تكون إحدى القيم التالية (EMAIL - PHONE - PAYPAL_ID)
  • receiver: وهو عنوان الحساب الوجهة قيمته بحسب نوع العنوان في الحقل السابق
  • amount: يتضمن العملة والقيمة المرسلة:
    • value: القيمة
    • currency: العملة

"items": [
  {
    "recipient_type": "EMAIL",
    "receiver": "receiver@example.com",
    "amount": {
      "value": "9.87",
      "currency": "USD"
    },
  }
]

بحسب لغة البرمجة أو إطار العمل المستخدم تقوم ببناء الطلب على الشكل السابق وإرساله