How to use Stripe API with Python

1# Install Stripe and Flask
2pip install stripe flask python-dotenv
3
4# Or for Django:
5# pip install stripe django python-dotenv

1# .env
2# STRIPE_SECRET_KEY=sk_test_your_key_here
3# STRIPE_PUBLISHABLE_KEY=pk_test_your_key_here
4# STRIPE_WEBHOOK_SECRET=whsec_your_secret_here
5
6# app.py
7import os
8import stripe
9from flask import Flask, request, jsonify
10from dotenv import load_dotenv
11
12load_dotenv()
13
14stripe.api_key = os.environ.get('STRIPE_SECRET_KEY')
15stripe.api_version = '2024-12-18.acacia'
16
17app = Flask(__name__)
18
19if not stripe.api_key:
20    raise ValueError('STRIPE_SECRET_KEY environment variable is not set')
21
22print('Stripe initialized with API version:', stripe.api_version)

1@app.route('/api/customers', methods=['POST'])
2def create_customer():
3    try:
4        data = request.get_json()
5        customer = stripe.Customer.create(
6            email=data.get('email'),
7            name=data.get('name'),
8            metadata={'app_user_id': data.get('userId', '')},
9        )
10        return jsonify({'customerId': customer.id})
11    except stripe.error.StripeError as e:
12        return jsonify({'error': str(e)}), 400
13
14
15@app.route('/api/create-payment-intent', methods=['POST'])
16def create_payment_intent():
17    try:
18        data = request.get_json()
19        intent = stripe.PaymentIntent.create(
20            amount=data['amount'],  # Amount in cents
21            currency='usd',
22            customer=data.get('customerId'),
23            automatic_payment_methods={'enabled': True},
24            metadata={'order_id': data.get('orderId', '')},
25        )
26        return jsonify({'clientSecret': intent.client_secret})
27    except stripe.error.StripeError as e:
28        return jsonify({'error': str(e)}), 400

1@app.route('/webhook', methods=['POST'])
2def webhook():
3    payload = request.get_data()  # Raw body bytes
4    sig_header = request.headers.get('Stripe-Signature')
5    webhook_secret = os.environ.get('STRIPE_WEBHOOK_SECRET')
6
7    try:
8        event = stripe.Webhook.construct_event(
9            payload, sig_header, webhook_secret
10        )
11    except ValueError:
12        return 'Invalid payload', 400
13    except stripe.error.SignatureVerificationError:
14        return 'Invalid signature', 400
15
16    # Handle the event
17    if event['type'] == 'payment_intent.succeeded':
18        intent = event['data']['object']
19        print(f"Payment succeeded: {intent['id']} (${intent['amount'] / 100})")
20    elif event['type'] == 'payment_intent.payment_failed':
21        intent = event['data']['object']
22        print(f"Payment failed: {intent['id']}")
23
24    return jsonify({'received': True})

1def handle_stripe_error(e):
2    if isinstance(e, stripe.error.CardError):
3        return jsonify({
4            'error': e.user_message,
5            'code': e.code,
6            'decline_code': e.json_body.get('error', {}).get('decline_code'),
7        }), 402
8    elif isinstance(e, stripe.error.RateLimitError):
9        return jsonify({'error': 'Too many requests. Please retry.'}), 429
10    elif isinstance(e, stripe.error.InvalidRequestError):
11        return jsonify({'error': str(e)}), 400
12    elif isinstance(e, stripe.error.AuthenticationError):
13        return jsonify({'error': 'Payment service configuration error.'}), 500
14    elif isinstance(e, stripe.error.APIConnectionError):
15        return jsonify({'error': 'Payment service temporarily unavailable.'}), 503
16    else:
17        return jsonify({'error': 'An unexpected error occurred.'}), 500

1# views.py (Django)
2import json
3import stripe
4from django.http import JsonResponse
5from django.views.decorators.csrf import csrf_exempt
6from django.views.decorators.http import require_POST
7import os
8
9stripe.api_key = os.environ.get('STRIPE_SECRET_KEY')
10
11@require_POST
12def create_payment_intent(request):
13    data = json.loads(request.body)
14    try:
15        intent = stripe.PaymentIntent.create(
16            amount=data['amount'],
17            currency='usd',
18            automatic_payment_methods={'enabled': True},
19        )
20        return JsonResponse({'clientSecret': intent.client_secret})
21    except stripe.error.StripeError as e:
22        return JsonResponse({'error': str(e)}, status=400)
23
24@csrf_exempt
25@require_POST
26def webhook(request):
27    payload = request.body  # Raw bytes
28    sig_header = request.META.get('HTTP_STRIPE_SIGNATURE')
29    try:
30        event = stripe.Webhook.construct_event(
31            payload, sig_header, os.environ.get('STRIPE_WEBHOOK_SECRET')
32        )
33    except (ValueError, stripe.error.SignatureVerificationError):
34        return JsonResponse({'error': 'Invalid'}, status=400)
35
36    if event['type'] == 'payment_intent.succeeded':
37        print('Payment succeeded:', event['data']['object']['id'])
38
39    return JsonResponse({'received': True})