تتيح واجهة برمجة التطبيقات الخاصة بنا للمستخدمين شراء أرصدة الشحن، والتي تكون مطلوبة لإنشاء شحنات باستخدام خيارات توصيل OTO بدون عقد. يشرح هذا الدليل كيفية شراء رصيد الشحن باستخدام نقطة النهاية buyShippingCredit.
التعليمات
الخطوة 1: نقطة النهاية لواجهة برمجة التطبيقات
- لشراء رصيد الشحن، استخدم نقطة النهاية POST التالية:
https://api.tryoto.com/rest/v2/buyShippingCredit
الخطوة 2: التفويض
- يجب تضمين رمز Bearer صالح في رؤوس الطلب للمصادقة
الخطوة 3: معلمات جسم الطلب
- يجب أن يكون جسم الطلب بتنسيق JSON ويتضمن الحقل التالي:
| اسم الحقل | إلزامي | النوع | الوصف |
|---|---|---|---|
amount | نعم | رقم | مقدار الرصيد المراد شراؤه. |
الخطوة 4: مثال على الطلب
باستخدام cURL:
curl --location 'https://api.tryoto.com/rest/v2/buyShippingCredit' \ --data '{ "amount": 11.50 }'
الخطوة 5: مثال على الاستجابة
- ستعيد استجابة ناجحة رابط دفع، مما يتيح للمستخدم إتمام المعاملة:
{ "success": true, "paymentURL": "https://checkout.payments.tap.company?mode=page&token=60c9c154d2b4650d89xxxx" }
