Create a marketplace panel (section)

Staging

https://fin-api.digetpay.com

POST

/v1/developer-portal/applications/{id}/listing/panels

Creates a backend-driven section of the listing detail page. Editable only while the listing is DRAFT / CHANGES_REQUESTED / REJECTED (max 20 panels). Cards are placed into a panel via panelId on the card create / update endpoints.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/jsonRequired

Example

{
    "panelType": "OCCASIONS",
    "layout": "HERO_CAROUSEL",
    "sortOrder": 0,
    "titleEn": "Gift cards",
    "titleAr": "بطاقات الهدايا",
    "showTitle": false,
    "featuredStoreId": "101",
    "featuredStoreLabelEn": "Acme Store",
    "featuredStoreLabelAr": "متجر أكمة",
    "subtitleEn": "Iftar & suhoor deals, all month",
    "subtitleAr": "عروض الإفطار والسحور طوال الشهر",
    "themeColor": "#16A34A",
    "bodyEn": "Buy a gift card and it lands instantly in your account.",
    "bodyAr": "اشترِ بطاقة هدايا وستصلك فوراً إلى حسابك.",
    "expiresAt": "2026-09-18T21:00:00Z"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://fin-api.digetpay.com/v1/developer-portal/applications//listing/panels' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "panelType": "OCCASIONS",
    "layout": "HERO_CAROUSEL",
    "sortOrder": 0,
    "titleEn": "Gift cards",
    "titleAr": "بطاقات الهدايا",
    "showTitle": false,
    "featuredStoreId": "101",
    "featuredStoreLabelEn": "Acme Store",
    "featuredStoreLabelAr": "متجر أكمة",
    "subtitleEn": "Iftar & suhoor deals, all month",
    "subtitleAr": "عروض الإفطار والسحور طوال الشهر",
    "themeColor": "#16A34A",
    "bodyEn": "Buy a gift card and it lands instantly in your account.",
    "bodyAr": "اشترِ بطاقة هدايا وستصلك فوراً إلى حسابك.",
    "expiresAt": "2026-09-18T21:00:00Z"
}'

Responses

🟢200OK

application/json

The created panel.

Bodyapplication/json

Example

{
    "id": "12",
    "sortOrder": 0,
    "layout": "HERO_CAROUSEL",
    "panelType": "OCCASIONS",
    "titleEn": "Gift cards",
    "titleAr": "بطاقات الهدايا",
    "showTitle": false,
    "featuredStoreId": "101",
    "featuredStoreLabelEn": "Acme Store",
    "featuredStoreLabelAr": "متجر أكمة",
    "subtitleEn": "Iftar & suhoor deals, all month",
    "subtitleAr": "عروض الإفطار والسحور طوال الشهر",
    "themeColor": "#16A34A",
    "bodyEn": "Buy a gift card and it lands instantly in your account.",
    "bodyAr": "اشترِ بطاقة هدايا وستصلك فوراً إلى حسابك.",
    "expiresAt": "2026-09-18T21:00:00.000Z",
    "bannerImageUrl": "https://storage/dgp/panel-banner.png",
    "offers": [
        {
            "id": "42",
            "panelId": "12",
            "sortOrder": 0,
            "titleEn": "Silver top-up",
            "titleAr": "تعبئة فضية",
            "descriptionEn": "string",
            "descriptionAr": "string",
            "imageUrl": "https://storage.googleapis.com/...?Signature=...",
            "design": "banner",
            "linkType": "deeplink",
            "url": "https://partner.acme.sa/buy/silver",
            "price": "49.99",
            "originalPrice": "79.99",
            "currency": "SAR",
            "inStock": true,
            "available": true,
            "perUserLimit": 5,
            "badgeLabel": "Best seller",
            "badgeColor": "#E8553C",
            "bannerImageUrl": "https://storage.googleapis.com/...?Signature=...",
            "highlightText": "Limited-time offer",
            "termsEn": "Digital card delivered instantly. Non-refundable.",
            "termsAr": "البطاقة الرقمية تُسلَّم فوراً وغير قابلة للاسترداد.",
            "offerExpiresAt": "2026-12-31T23:59:59.000Z",
            "fulfillmentMode": "INSTANT"
        }
    ]
}

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

Modified at 2026-09-16 09:43:02

List marketplace panels (sections)

Reorder marketplace panels (sections)