الرسوم

يقدّم هذا الدليل التوجيهي نظرة عامة على حالات استخدام الرسوم المختلفة المتاحة، بالإضافة إلى تعليمات مفصّلة حول كيفية تحديد الرسوم مقابل روابط الإجراءات ضمن خلاصاتك.

نوع الرسوم

يتيح التطبيق نوعَي الرسوم DELIVERY وSERVICE.

خدمة توصيل

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

خدمة

{
  "fee": {
    "fee_id": "12345/service_fee",
    "fee_type": "SERVICE",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

خلاصات الرسوم

يوضّح ما يلي حالات الاستخدام المختلفة المتاحة، مع أمثلة على نماذج.

  • رسوم ثابتة: يتم تحصيل رسوم ثابتة مقابل الخدمة، وتُعرف باسم fixed_amount.
  • الرسوم بالنسبة المئوية: يتم تحصيل نسبة مئوية من إجمالي سلة التسوّق كرسوم خدمة. بالإضافة إلى ذلك، يمكنك تحديد base_value بالإضافة إلى رسوم cart_percentage.
  • نطاقات الرسوم: الرسوم ضمن النطاق المحدّد على أنّه range_amount للحد الأدنى والأقصى.

ثابت

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

النسبة المئوية لسلة التسوّق

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "cart_percentage": {
      "base_value": {
        "currency_code": "USD",
        "units": 3,
        "nanos": 500000000
      },
      "percentage_of_cart_value": 10
    },
    "service_ids": [
      "service/entity002"
    ]
  }
}

النطاق

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "range_amount": {
      "min_amount": {
        "currency_code": "USD",
        "units": 3,
        "nanos": 500000000
      },
      "max_amount": {
        "currency_code": "USD",
        "units": 5,
        "nanos": 600000000
      }
    },
    "service_ids": [
      "service/entity002"
    ]
  }
}