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, and GET /v3/billing-methods/{billingMethodId} returns 422 when called against an Express method.Status values vary by type
Allowedstatus values depend on the billing method type:
Only
active billing methods can be used to send gifts. draft methods are configured but not yet ready; archived methods have been retired; expired methods have passed their expiration date.
Remaining balance
ThespendingLimit.remaining field reports the current balance available on the billing method. For Invoice billing methods, spendingLimit is null because there’s no spending cap.
Always check remaining balance before sending high-value gifts - Snappy rejects 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. Pass theSnappy-Account-Id header to scope your query to a specific Account when your API key has access to multiple Accounts.
How to Work with Billing Methods
List billing methodstype, status, or remainingBalance range.
Get a single billing method
422 for billing methods that exist but aren’t supported through the public API (e.g. Express).
Billing Methods are currently read-only through the public API. To create, update, or archive Billing Methods, use the Snappy Dashboard.