Examples
This section provides practical examples of using the Cardinity Python SDK. Each example includes complete, runnable code with explanations.
Note
All examples use test credentials and test card numbers. Replace them with your actual credentials and real data for production use.
Available Examples
Note
Code examples are available in the examples/
directory of the repository.
Quick Reference
Common Test Data
Use these test values when running examples:
Test Credentials:
CONSUMER_KEY = "test_jlol6sogrlvje2zwwsfb6kjajuyy7h"
CONSUMER_SECRET = "1h7j6rvwlpvuwbzrobo6bjbcqv1m3khnlqojpkkwh9wzbrlkmu"
Test Card Numbers:
Visa Success: 4111111111111111
MasterCard Success: 5555555555554444
Visa 3DS Success: 4444333322221111
American Express Success: 378282246310005
Failure (any amount >150): Any valid card number
Test Amounts:
Success: Any amount < 150.00
Failure: Any amount >= 150.00
3DS Required: Depends on card and amount
Running Examples
Prerequisites
Install the SDK:
pip install cardinity-python
Set up environment variables (recommended):
export CARDINITY_CONSUMER_KEY="test_jlol6sogrlvje2zwwsfb6kjajuyy7h" export CARDINITY_CONSUMER_SECRET="1h7j6rvwlpvuwbzrobo6bjbcqv1m3khnlqojpkkwh9wzbrlkmu"
Copy and run any example:
python basic_payment.py
Example Structure
Each example follows this structure:
"""
Example: Description
This example demonstrates how to...
"""
import os
from cardinity import Cardinity, CardinityError
# Configuration
cardinity = Cardinity(
consumer_key=os.getenv("CARDINITY_CONSUMER_KEY", "test_key"),
consumer_secret=os.getenv("CARDINITY_CONSUMER_SECRET", "test_secret")
)
def main():
try:
# Example code here
pass
except CardinityError as e:
print(f"Error: {e}")
if __name__ == "__main__":
main()
Integration Examples
For real-world integration scenarios, see:
E-commerce Integration: Complete checkout flow
Subscription Billing: Recurring payment setup
Marketplace Payments: Multi-vendor scenarios
Mobile App Integration: API integration patterns
Webhook Handling: Processing payment notifications
Next Steps
Start with
basic_payment.py
for simple payment processingLearn about
3ds_payment.py
for secure authenticationImplement proper error handling for robust applications
Explore advanced SDK features for complex scenarios
Need Help?
Visit our GitHub Issues
Contact support at contact@cardinity.com