Skip to main content
A Billing Method is how an Account pays for marketplace orders, triggered gifts, and associated fees. Each Account can have one or more Billing Methods, with one set as the default - applied automatically to Campaigns created via the API (Triggered Gifting) and available for reference on marketplace orders (Embedded Marketplace). The Billing Methods API exposes an Account’s billing methods, so you can discover which are available through the public API, check remaining budget, and confirm a billing method is valid before placing marketplace orders or triggering gifts.
Want to understand how Billing Methods fit into the bigger picture? Check out the Core Concepts & Data Models page.
Billing Methods are referenced in V3 API requests by the fundingSourceId field (for example, on POST /orders).

​
The Billing Method Object

​
Key Concepts & Business Rules

​
Billing Method types

Snappy supports four billing method types through the public API:
Express billing methods exist for some accounts but are intentionally excluded from the public API. They will not appear in GET /v3/billing-methods responses. GET /v3/billing-methods/{billingMethodId} returns 422 when called against an Express method or when the target Account is inactive.

​
Status values vary by type

Allowed status values depend on the billing method type: Only active billing methods can be used to place marketplace orders or trigger gifts. draft methods are configured but not yet ready; archived methods have been retired; expired methods have passed their expiration date.

​
Remaining balance

The spendingLimit.remaining field reports the current balance available on the billing method, in USD dollars (e.g. 7250.5 = $7,250.50). For Invoice billing methods, spendingLimit is null because there’s no spending cap. Always check remaining balance before placing high-value marketplace orders or triggering high-value gifts - Snappy rejects order and gift creation when the selected billing method has insufficient funds.

​
Default Billing Method

Each Account has one Billing Method set as the default. This default is applied automatically to any Campaign created via the API. For Embedded Marketplace (POST /orders), the billing method is referenced via the fundingSourceId field, and a matching Campaign is auto-selected or created based on that funding source.

​
Account scoping

Billing Methods are scoped to an Account. All Billing Methods endpoints require the Snappy-Account-Id header to identify which Account’s billing methods to query.

​
Permissions

All Billing Methods endpoints require the billingMethods:read scope on your API key.

​
How to Work with Billing Methods

List billing methods
Returns the billing methods on the Account that are usable through the public API. Filter by type, status, or remainingBalance range. Get a single billing method
Returns a single billing method by its ID. Returns 422 when called against an unsupported billing method type (e.g. Express) or an inactive Account.
Billing Methods are currently read-only through the public API. To create, update, or archive Billing Methods, use the Snappy Dashboard.
Last modified on July 9, 2026