Stripe — data contract (raw Stripe Charge export at ingest; not affiliated with Stripe)
Raw Stripe Charge object at ingest. Compatible with Stripe's API Charge object; not affiliated with Stripe. Root of the Stripe charges contract family.
This contract is one boundary in the Stripe charges pipeline chain. Validate the payload at that boundary, then follow the neighbors.
Also available: ODCS v3.1.0 YAML. “Use this contract” forks it into your org, then opens the validation playground so you can upload the client file.
Contract family
Stripe charges pipeline
Stripe charges as they move from raw ingest, through a cleaned stage and a daily revenue mart, to a partner payout feed. Not affiliated with Stripe. Sample ids are fake.
- Ingest1stripe_charges_rawThis contract
- Between stages
Derived from stripe_charges_raw
- Between stages
Derived from stripe_charges_staged
- Egress
Derived from revenue_daily_mart
Fields
| Name | Type | Required | Rule | Description |
|---|---|---|---|---|
| id | string | required | pattern /^(ch|py)_[A-Za-z0-9]+$/ | Charge id. Card charges use ch_; some bank-debit / Connect objects use py_. |
| object | string | required | one of: charge | — |
| amount | integer | required | ≥ 0 | Amount intended to be collected, in the smallest currency unit (e.g. cents). |
| amount_captured | integer | optional | ≥ 0 | — |
| amount_refunded | integer | optional | ≥ 0 | — |
| currency | string | required | pattern /^[a-z]{3}$/ | Three-letter ISO currency code, lowercase. |
| customer | string | optional | pattern /^cus_[A-Za-z0-9]+$/ | — |
| description | string | optional | — | — |
| paid | boolean | required | — | — |
| refunded | boolean | required | — | — |
| captured | boolean | optional | — | — |
| status | string | required | one of: succeeded, pending, failed | The status of the payment. |
| created | integer | required | ≥ 0 | Unix epoch seconds when the object was created. |
| livemode | boolean | optional | — | — |
| receipt_email | string | optional | email format | — |
| payment_intent | string | optional | pattern /^pi_[A-Za-z0-9]+$/ | — |
Sample rows
One synthetic row we wrote. It validates against this contract with zero violations. No real customer data.
[
{
"amount": 4299,
"amount_captured": 4299,
"amount_refunded": 0,
"captured": true,
"created": 1735689600,
"currency": "usd",
"customer": "cus_DemoAcme0001",
"description": "Demo invoice INV-DEMO-1001",
"id": "ch_3Qdemo0001AaBbCcDd",
"livemode": false,
"object": "charge",
"paid": true,
"payment_intent": "pi_3Qdemo0001AaBbCc",
"receipt_email": "billing-demo@example.com",
"refunded": false,
"status": "succeeded"
}
]Provenance
- Verified against
- https://docs.stripe.com/api/charges/object
- Checked
- 2026-11-09
- Version
- v1.0
- Author
- DataContractGate
- License
- MIT
Spotted a mismatch with the vendor’s current schema? Report an issue.
Stripe, Shopify, QuickBooks, Xero, HubSpot, Salesforce, Google Analytics and Square are trademarks of their respective owners. DataContractGate is not affiliated with or endorsed by them. These contracts describe data shaped like these vendors’ documented schemas; they are not official and are not certified by any vendor.