---
title: "Add advertising funds with a one-time payment (website only)"
method: POST
path: "/v1/owner/ads/topup"
tags: ["Business Owner"]
---

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

`POST /v1/owner/ads/topup`

## Request

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

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).

## Request body

- object
  - `business_id` string
  - `amount_cents` number, required: Within the top-up limits (default $25 to $5,000).
  - `save_card` boolean, required
  - `request_id` string, required: Client id of this confirmation (8-100 characters); reuse it only to retry the same confirmation.
  - `consent_sha256` string, required: SHA-256 of the one-time payment consent text shown (from the quote).
  - `save_card_consent_sha256` string: Only with save_card true: SHA-256 of the save-card consent text shown.

## Response `200`

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

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

## Other responses

- `400`: ErrorResponse
- `401`: ErrorResponse
- `403`: ErrorResponse
- `404`: ErrorResponse
- `409`: ErrorResponse
- `413`: ErrorResponse
- `429`: RateLimitError
- `default`: ErrorResponse

---

[API](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents.md) · [All operations](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/revisions/37285f7cddcd?raw)