Aura Logo
AuraAPI Docs
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 UUID
  • amount - Amount in cents (integer)
  • payment_date - ISO 8601 date
  • status - Payment status
  • source - Payment source identifier
POST
/v1/payments
amountinteger

Amount in CENTS (integer). Note: /v1/analytics/* endpoints return revenue in DOLLARS (decimal). This asymmetry exists because payments mirror Stripe's cents convention while analytics aggregate human-readable totals.

Range0 <= value
call_id?string

Call ID this payment is linked to

Formatuuid
currency?string

ISO 4217 currency code

Default"USD"
external_id?string

External payment/transaction ID

lead_idstring

Lead ID this payment is from

Formatuuid
payment_datestring

ISO 8601 payment date

Formatdate-time
product_id?string

Product ID this payment is for

Formatuuid
sourcestring

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

statusstring

Payment status

Value in"pending" | "succeeded" | "failed" | "refunded"

Response Body

application/json

application/json

application/json

curl -X POST "https://api.aura-app.ai/v1/payments" \  -H "Content-Type: application/json" \  -d '{    "amount": 500000,    "lead_id": "550e8400-e29b-41d4-a716-446655440000",    "payment_date": "2026-01-17T08:00:00Z",    "source": "manual",    "status": "succeeded"  }'
{
  "data": {
    "amount": 5000,
    "call_id": "0d0a16ab-a508-4d58-bf24-5dc3cb248f3e",
    "created_at": "2019-08-24T14:15:22Z",
    "currency": "usd",
    "customer_email": "string",
    "customer_name": "string",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "lead_id": "9bddab70-98e6-43a9-8f32-c9788b9de0c0",
    "match_candidates": [
      {
        "call_id": "string",
        "lead_id": "string",
        "reason": "string",
        "score": 0,
        "property1": null,
        "property2": null
      }
    ],
    "match_confidence": 0,
    "matched_by": "string",
    "matched_product_id": "58781463-d64e-401a-ada0-d94ad1295fc2",
    "organization_id": "string",
    "payment_date": "2019-08-24T14:15:22Z",
    "provider": "stripe",
    "provider_payment_id": "pi_xxxxx",
    "refund_reason": "string",
    "refund_status": "string",
    "refunded_amount": 0,
    "refunded_at": "2019-08-24T14:15:22Z",
    "status": "succeeded",
    "stripe_charge_id": "string",
    "stripe_customer_id": "string",
    "stripe_product_id": "string",
    "stripe_refund_id": "string",
    "stripe_subscription_id": "string",
    "verification_status": "confirmed",
    "verified_at": "2019-08-24T14:15:22Z"
  },
  "success": true
}
{
  "code": "NOT_FOUND",
  "error": "Lead not found",
  "requestId": "req_abc123",
  "success": false
}
{
  "code": "NOT_FOUND",
  "error": "Lead not found",
  "requestId": "req_abc123",
  "success": false
}