Skip to main content

​
Overview

A preset amount deposit lets you specify exactly how much the customer will deposit. The customer does not enter an amount — it is locked to the value you set. This is ideal when your platform offers predefined deposit tiers (e.g. 25,25, 50, $100).

​
How It Works

  1. You create a checkout session with type: "deposit" and include fixed_amount_cents.
  2. The customer is redirected to the Soap-hosted checkout page with the amount pre-filled and locked.
  3. The customer selects a payment method and confirms.
  4. Upon completion, a webhook is fired and the customer is redirected back to your app.

​
API Request

curl -X POST 'https://api-sandbox.paywithsoap.com/api/v1/checkouts' \
--header 'Content-Type: application/json' \
--header 'Authorization: YOUR_API_KEY' \
--data '{
    "customer_id": "cus_vi57KegYgcRqcGHqip8q6UZiqtrwMT870",
    "type": "deposit",
    "fixed_amount_cents": 10000,
    "experience": "web",
    "return_url": "https://myapp.com/wallet"
}'

​
Key Parameters

ParameterRequiredDescription
customer_idYesThe customer’s unique identifier
typeYesMust be "deposit"
fixed_amount_centsYesThe exact deposit amount in cents (e.g. 10000 = $100)
experienceNo"web" or "webview"
return_urlNoWhere to redirect the customer after completion

​
When to Use

  • You offer predefined deposit tiers (25,25, 50, $100, etc.)
  • Promotional deposits with a fixed bonus amount
  • Any scenario where you control the deposit amount

← Back to Create Checkout

View the full API reference for creating checkouts.