Business Owner

Add advertising funds with a one-time payment (website only)

Creates a Stripe Checkout payment for a one-time prepaid top-up after the owner confirmed the amount, taxes, fees and total. Funds are credited only after Stripe confirms the payment. The card is saved only when save_card is true with its own consent; saving a card never turns on automatic charges. Requires accepted Advertiser Terms (409 ads_terms_required) and LOPPEE_ADS_BILLING test or live. Website only: requests from the mobile apps are refused with 403 web_only_action. Only the business's human owner can do this: agent credentials are refused with 403 ads_owner_action_required, and a fresh second factor is required (403 owner_step_up_required).

post/v1/owner/ads/topup

Request

  • Base URL: https://loppee.com
  • URL: https://loppee.com/v1/owner/ads/topup
  • Auth: HTTP bearer

Request body

business_idstring
amount_centsnumber required

Within the top-up limits (default $25 to $5,000).

save_cardboolean required
request_idstring required

Client id of this confirmation (8-100 characters); reuse it only to retry the same confirmation.

consent_sha256string required

SHA-256 of the one-time payment consent text shown (from the quote).

save_card_consent_sha256string

Only with save_card true: SHA-256 of the save-card consent text shown.

Response

Add advertising funds with a one-time payment (website only) response

object required

Pending top-up with the Stripe Checkout URL on the website.

Changes

No recorded changes to this operation across all 1 revision of this API.