Skip to main content
POST
Record payment
Record a payment from any source (Stripe, FanBasis, WOP, manual, etc.). Send an Idempotency-Key header when retrying the same create request. A completed retry returns the existing payment. A request still being processed returns 409. Use a new key for a different payment. Use Cases:
  • Record payments from external payment processors
  • Manual payment entry for offline transactions
  • Sync payments from partner platforms
Required fields:
  • lead_id - Associated lead UUID
  • amount - Amount in dollars, stored to two decimal places
  • payment_date - ISO 8601 date
  • status - Payment status
  • source - Payment source identifier

Headers

Idempotency-Key
string

Optional retry key scoped to your organization. Reuse the same key and request body when retrying one create. Use a new key for a different create. A completed request returns the existing resource; a request still in progress returns 409.

Example:

"8f3a1c2e-3b9d-4f5a-9c7e-1a2b3c4d5e6f"

Body

application/json
amount
number
required

Payment amount in dollars, stored to two decimal places. For example, 5000.00 means five thousand dollars. The database rounds additional decimal places. Create, update, and payment reads use the same unit.

Required range: x > 0
Example:

5000

lead_id
string
required

Lead ID this payment is from

Example:

"550e8400-e29b-41d4-a716-446655440000"

payment_date
string<date-time>
required

ISO 8601 payment date

Example:

"2026-01-17T08:00:00Z"

source
string
required

Payment source (e.g., "stripe", "fanbasis", "wop", "manual")

Example:

"manual"

status
enum<string>
required

Payment status

Available options:
pending,
succeeded,
failed,
refunded
Example:

"succeeded"

call_id
string

Call ID this payment is linked to

currency
string
default:USD

Supported currency code, such as USD. Defaults to USD when omitted. Whitespace and letter case are normalized.

Example:

"USD"

external_id
string

External payment/transaction ID

Example:

"pi_3abc123"

product_id
string

Product ID this payment is for

Response

Successfully recorded payment

data
object
required
success
enum<boolean>
required
Available options:
true