> ## Documentation Index
> Fetch the complete documentation index at: https://devkit4ai.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Get My Payment History
> Get the current user's Stripe payment history for the project
Retrieve a paginated list of payment transactions for the authenticated user within their project. Useful for displaying billing history and invoice records.
## Authentication
This endpoint requires end user authentication via HTTP Bearer Token with project scope.
## Query Parameters
Use test mode data. Set to `false` for production payments.
Page number for pagination (minimum: 1)
Number of payments per page (1-100)
## Response
List of payment records
Internal payment record ID
Project the payment belongs to
Related subscription (if recurring)
User who made the payment
Whether this is a test mode payment
Stripe Payment Intent ID
Payment status: `succeeded`, `pending`, `failed`
Payment amount in cents
Three-letter currency code (e.g., `usd`)
Payment description
Amount refunded in cents (default: 0)
When payment was created
Total number of payments
Current page number
Number of items per page
## Example Request
```bash theme={null}
curl -X GET "https://api.devkit4ai.com/api/v1/payments/stripe/my-payments?test_mode=true&page=1&page_size=10" \
-H "Authorization: Bearer {end_user_jwt}"
```
## Example Response
```json theme={null}
{
"payments": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"project_id": "660e8400-e29b-41d4-a716-446655440000",
"subscription_id": "770e8400-e29b-41d4-a716-446655440000",
"user_id": "880e8400-e29b-41d4-a716-446655440000",
"is_test_mode": true,
"payment_intent_id": "pi_1ABC123def456",
"status": "succeeded",
"amount_cents": 2999,
"currency": "usd",
"description": "Pro Plan - Monthly",
"refunded_amount_cents": 0,
"created_at": "2026-01-15T10:30:00Z"
},
{
"id": "550e8400-e29b-41d4-a716-446655440001",
"project_id": "660e8400-e29b-41d4-a716-446655440000",
"subscription_id": "770e8400-e29b-41d4-a716-446655440000",
"user_id": "880e8400-e29b-41d4-a716-446655440000",
"is_test_mode": true,
"payment_intent_id": "pi_1DEF456ghi789",
"status": "succeeded",
"amount_cents": 2999,
"currency": "usd",
"description": "Pro Plan - Monthly",
"refunded_amount_cents": 0,
"created_at": "2025-12-15T10:30:00Z"
}
],
"total": 2,
"page": 1,
"page_size": 10
}
```
## Formatting Amounts
Amounts are stored in cents. Convert to display format:
```typescript theme={null}
function formatAmount(cents: number, currency: string): string {
return new Intl.NumberFormat('en-US', {
style: 'currency',
currency: currency.toUpperCase()
}).format(cents / 100);
}
// formatAmount(2999, 'usd') → "$29.99"
```
## Integration Example
```typescript theme={null}
// Billing history component
function BillingHistory() {
const [payments, setPayments] = useState([]);
const [page, setPage] = useState(1);
useEffect(() => {
fetch(`/api/my-payments?page=${page}`)
.then(res => res.json())
.then(data => setPayments(data.payments));
}, [page]);
return (