Update a marketplace offer (card)

patch

https://api.digetpay.com/v1/developer-portal/applications/{id}/listing/offers/{offerId}

Partial update of one card. Editable only while the listing is DRAFT / CHANGES_REQUESTED / REJECTED. Setting price to null makes the card not-purchasable; inStock: false soft-disables it without deletion. Set panelId to move the card to another section.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

^[0-9]+$

Application ID (numeric string, stringified bigint)

offerId

string

required

^[0-9]+$

Offer ID (numeric string, stringified bigint)

Body Params

titleEn

string

length ≤ 200

Offer (card) title — English

titleAr

string

length ≤ 200

Offer (card) title — Arabic

descriptionEn

string

length ≤ 2000

Offer description (English). Null clears the value.

descriptionAr

string

length ≤ 2000

Offer description (Arabic). Null clears the value.

imageUrl

string

length ≤ 2048

Card thumbnail: absolute https/http URL, a gs:// object path, or empty.

design

string

enum

Card visual design

Allowed:

linkType

string

enum

Launch behavior (deeplink / webview / offer).

Allowed:

url

string

length ≤ 2048

Launch target. webview requires http(s), deeplink accepts any scheme, offer allows empty string or valid URL.

price

string

\d{1,7}(\.\d{1,2})?

Unit price as a decimal string (≤ 9,999,999.99). Null clears the price.

originalPrice

string

\d{1,7}(\.\d{1,2})?

Pre-discount unit price (shown struck through). Null clears the discount.

currency

string

length ≤ 3

ISO 4217 currency code for the price

inStock

boolean

Whether the card is in stock / purchasable now

perUserLimit

number

1 to 999

Purchase limit per customer. Null clears the limit (unlimited).

badgeLabel

string

length ≤ 60

Attention badge label. Null clears the badge.

badgeColor

string

^#[0-9a-fA-F]{6}$

Hex badge color. Null clears the color.

bannerImageUrl

string

length ≤ 2048

Full-width hero image for the card's detail screen. Null clears it.

highlightText

string

length ≤ 200

Short highlight copy. Null clears it.

termsEn

string

length ≤ 2000

Purchase terms (English). Null clears it.

termsAr

string

length ≤ 2000

Purchase terms (Arabic). Null clears it.

offerExpiresAt

string

ISO 8601 expiry for purchasability. Null clears the expiry (never expires).

panelId

string

^[0-9]+$

Move the card to another panel (stringified bigint). The target panel must belong to the same listing.

sortOrder

number

0 to 999

Explicit sort order within the panel (0-based).

fulfillmentMode

string

enum

Fulfillment behavior after payment.

Allowed:

Responses

400

Invalid payload, or the listing is not editable in its status.

401

Missing or invalid developer-portal JWT.

404

Application not found, or offer not in this listing.

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The updated offer.