Opłaty

W tym samouczku omawiamy różne obsługiwane przypadki użycia opłat oraz szczegółowe instrukcje określania opłat za linki do działań w plikach danych.

Typ opłaty

Aplikacja obsługuje rodzaje opłat DELIVERY i SERVICE.

Dostawa

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

Usługa

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

Pliki danych o opłatach

Poniżej przedstawiamy różne obsługiwane przypadki użycia wraz z przykładami.

  • Opłaty stałe: za usługę jest naliczana opłata stała (fixed_amount).
  • Opłata procentowa: procent łącznej wartości koszyka jest pobierany jako opłata za obsługę. Oprócz opłaty cart_percentage możesz też określić base_value.
  • Zakresy opłat: opłaty w zakresie zdefiniowanym jako range_amount dla wartości minimalnej i maksymalnej.

Naprawiono

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

Procent koszyka

{
  "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"
    ]
  }
}

Zakres

{
  "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"
    ]
  }
}