Settings

2 API calls in this section.

Get Portal Settings

Customer Portal / Delivery Management / Settings

GET/customer/delivery/portal-settings

Returns the effective tenant configuration and configured resources for the customer portal delivery creation flow. Authentication: - Requires Authorization: Bearer {{access_token}}. Frontend integration contract: - Read delivery services from data.resources.delivery_services. - Use each service id as delivery_service_id when creating an order. - Use delivery_type.code for delivery-type-specific UI behavior; delivery_type can be null only when the service has no related type. - Use data.delivery_service_settings.default_delivery_service_id to preselect the configured default service. Important errors: - HTTP 401 when the customer or tenant context is missing. - HTTP 500 when portal settings cannot be loaded.

Send a bearer token in the Authorization header for an authenticated OnDi user session.

Request

curl

1curl --request GET "$ONDI_BASE_URL/customer/delivery/portal-settings" \2  --header "Authorization: Bearer {{access_token}}"

Headers

AuthorizationOptional

header string

Bearer {{access_token}}

Responses

Success200

Response body

json

1{2  "success": true,3  "data": {4    "pickup_settings": {5      "mode": "predefined_only",6      "allow_change": true,7      "default_pickup_address_id": "uuid"8    },9    "delivery_service_settings": {10      "default_delivery_service_id": "service-uuid"11    },12    "cod_settings": {13      "enabled": true,14      "required": false,15      "allow_zero": true,16      "min": 0,17      "max": 50000018    },19    "delivery_creation_fields": {20      "reference_id_enabled": true,21      "invoicing_enabled": false,22      "custom_shipment_label_enabled": false23    },24    "package_settings": {25      "multipart_enabled": true26    },27    "visibility_settings": {28      "driver_info": {29        "show_driver_info": true,30        "show_driver_phone": false31      },32      "tracking": {33        "realtime_tracking_enabled": true34      },35      "chat": {36        "support_chat_enabled": true,37        "driver_chat_enabled": false38      }39    },40    "support_ticket_settings": {41      "enabled": true,42      "allow_customer_close": true,43      "default_priority": "medium"44    },45    "currency": {46      "currency_code": "IQD",47      "currency_symbol": "د.ع",48      "currency_name": "Iraqi Dinar",49      "exchange_rate_to_system": 150    },51    "resources": {52      "pickup_addresses": [],53      "delivery_services": [54        {55          "id": "service-uuid",56          "name": "Standard Delivery",57          "code": "STD",58          "service_level": "standard",59          "delivery_type": {60            "id": "delivery-type-uuid",61            "name": "Delivery",62            "code": "delivery"63          }64        }65      ]66    }67  }68}

Get Payment Methods

Customer Portal / Delivery Management / Settings

GET/customer/delivery/payment-methods

Lists payment methods available for the customer delivery portal (delivery module only). - Filters by allowed_modules containing 'ALL' (excludes RESTAURANT-only methods like Pay at Counter) - Respects tenant_payment_method_settings and portal cod_settings (COD hidden when disabled) - For gateways: checks tenant_gateway_configs (tenant mode) or system_gateway_configs (system mode) Response fields: id, gateway_code (use for payment.method in create order), name, type, display_name (jsonb), icon_url, description (jsonb), is_gateway

Send a bearer token in the Authorization header for an authenticated OnDi user session.

Request

curl

1curl --request GET "$ONDI_BASE_URL/customer/delivery/payment-methods" \2  --header "Authorization: Bearer {{access_token}}"

Headers

AuthorizationOptional

header string

Bearer {{access_token}}

Responses

Success200OK

Response body

json

1{2  "success": true,3  "data": {4    "payment_methods": [5      {6        "id": "0760f75f-4aee-4776-afc0-4057d7ad458f",7        "gateway_code": "cod",8        "name": "Cash on Delivery",9        "type": "COD",10        "display_name": {11          "en": "Cash on Delivery",12          "ar": "الدفع عند الاستلام",13          "ku": "پارەدان لە کاتی وەرگرتن"14        },15        "icon_url": null,16        "description": {17          "en": "Pay when you receive your order"18        },19        "is_gateway": false20      },21      {22        "id": "c3164119-6fa4-4917-8021-b33a40ce7462",23        "gateway_code": "wallet",24        "name": "Wallet Payment",25        "type": "WALLET",26        "display_name": {27          "en": "Wallet",28          "ar": "المحفظة",29          "ku": "جزدان"30        },31        "icon_url": null,32        "description": {33          "en": "Pay using your wallet balance"34        },35        "is_gateway": false36      },37      {38        "id": "34814962-2627-43d2-a3ae-c1c473e1cf3d",39        "gateway_code": "NASS",40        "name": "Nass",41        "type": "GATEWAY",42        "display_name": {43          "en": "Nass Payment",44          "ar": "دفع ناس",45          "ku": "پارەدانی ناس"46        },47        "icon_url": "https://api.ondi.io/storage/v1/object/public/system/brand/nass.png",48        "description": {49          "en": "Nass payment gateway integration"50        },51        "is_gateway": true52      }53    ]54  }55}