OpenapiV1Payments
Record payment
Record a payment from any source (Stripe, FanBasis, WOP, manual, etc.)
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 UUIDamount- Amount in cents (integer)payment_date- ISO 8601 datestatus- Payment statussource- Payment source identifier
lead_idstring
Lead ID this payment is from
Format
uuidcall_id?string
Call ID this payment is linked to
Format
uuidproduct_id?string
Product ID this payment is for
Format
uuidamountinteger
Amount in cents
Range
0 <= valuecurrency?string
ISO 4217 currency code
Default
"USD"payment_datestring
ISO 8601 payment date
Format
date-timestatusstring
Payment status
Value in
"pending" | "succeeded" | "failed" | "refunded"sourcestring
Payment source (e.g., "stripe", "fanbasis", "wop", "manual")
external_id?string
External payment/transaction ID
Response Body
application/json
application/json
application/json
curl -X POST "https://api.aura-app.ai/v1/payments" \ -H "Content-Type: application/json" \ -d '{ "lead_id": "550e8400-e29b-41d4-a716-446655440000", "amount": 500000, "payment_date": "2026-01-17T08:00:00Z", "status": "succeeded", "source": "manual" }'{
"success": true,
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"organization_id": "string",
"provider": "stripe",
"provider_payment_id": "pi_xxxxx",
"amount": 5000,
"currency": "usd",
"status": "succeeded",
"customer_email": "string",
"customer_name": "string",
"lead_id": "9bddab70-98e6-43a9-8f32-c9788b9de0c0",
"call_id": "0d0a16ab-a508-4d58-bf24-5dc3cb248f3e",
"payment_date": "2019-08-24T14:15:22Z",
"created_at": "2019-08-24T14:15:22Z",
"verification_status": "confirmed",
"verified_at": "2019-08-24T14:15:22Z",
"stripe_charge_id": "string",
"stripe_customer_id": "string",
"stripe_subscription_id": "string",
"matched_by": "string",
"match_confidence": 0,
"match_candidates": null,
"refund_status": "string",
"refunded_amount": 0,
"refunded_at": "2019-08-24T14:15:22Z",
"stripe_refund_id": "string",
"refund_reason": "string",
"stripe_product_id": "string",
"matched_product_id": "58781463-d64e-401a-ada0-d94ad1295fc2"
}
}{
"success": false,
"error": "Lead not found",
"code": "NOT_FOUND",
"requestId": "req_abc123"
}{
"success": false,
"error": "Lead not found",
"code": "NOT_FOUND",
"requestId": "req_abc123"
}