Create a marketplace offer (card)

Staging

https://fin-api.digetpay.com

POST

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

Creates one card for the listing and appends it to the end of the display order of its panel (ALL_CARDS by default, or the panel given via panelId). Editable only while the listing is DRAFT / CHANGES_REQUESTED / REJECTED (max 20 cards). A card is purchasable once price is set and inStock is true.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Path Params

Body Params application/jsonRequired

Example

{
    "titleEn": "Silver top-up",
    "titleAr": "تعبئة فضية",
    "descriptionEn": "Top up your mobile with SAR 50 instantly.",
    "descriptionAr": "شحن رصيد هاتفك بمبلغ 50 ريال فوراً.",
    "imageUrl": "https://cdn.acme.sa/topup-silver.png",
    "design": "banner",
    "linkType": "deeplink",
    "url": "https://partner.acme.sa/buy/silver",
    "price": "49.99",
    "originalPrice": "79.99",
    "currency": "SAR",
    "inStock": true,
    "perUserLimit": 5,
    "badgeLabel": "Best seller",
    "badgeColor": "#E8553C",
    "bannerImageUrl": "https://cdn.acme.sa/topup-silver-hero.png",
    "highlightText": "Limited-time offer",
    "termsEn": "Digital card delivered instantly. Non-refundable.",
    "termsAr": "البطاقة الرقمية تُسلَّم فوراً وغير قابلة للاسترداد.",
    "offerExpiresAt": "2026-12-31T23:59:59.000Z",
    "panelId": "12",
    "fulfillmentMode": "INSTANT"
}

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/offers' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "titleEn": "Silver top-up",
    "titleAr": "تعبئة فضية",
    "descriptionEn": "Top up your mobile with SAR 50 instantly.",
    "descriptionAr": "شحن رصيد هاتفك بمبلغ 50 ريال فوراً.",
    "imageUrl": "https://cdn.acme.sa/topup-silver.png",
    "design": "banner",
    "linkType": "deeplink",
    "url": "https://partner.acme.sa/buy/silver",
    "price": "49.99",
    "originalPrice": "79.99",
    "currency": "SAR",
    "inStock": true,
    "perUserLimit": 5,
    "badgeLabel": "Best seller",
    "badgeColor": "#E8553C",
    "bannerImageUrl": "https://cdn.acme.sa/topup-silver-hero.png",
    "highlightText": "Limited-time offer",
    "termsEn": "Digital card delivered instantly. Non-refundable.",
    "termsAr": "البطاقة الرقمية تُسلَّم فوراً وغير قابلة للاسترداد.",
    "offerExpiresAt": "2026-12-31T23:59:59.000Z",
    "panelId": "12",
    "fulfillmentMode": "INSTANT"
}'

Responses

🟢200OK

application/json

The created offer.

Bodyapplication/json

Example

{
    "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 authored marketplace offers (cards)

Reorder marketplace offers