Common Design Patterns at Stripe

Mike's Notes

An excellent series of articles on designing APIs from Stripe, The Payment Service Provider. There are detailed examples and coding conventions.

Stripe also has superb Developer Docs, which are a helpful format to start with when designing Pipi Docs, especially for the API.

Resources

• https://stripe.com/
• https://docs.stripe.com/keys
• https://docs.stripe.com/rate-limits
• https://docs.stripe.com/error-codes
• https://docs.stripe.com/stripe-cli/overview
• https://docs.stripe.com/stripe-shell/launch
https://markdoc.dev/docs/overview

References

• Reference

Repository

• Home > Ajabbi Research > Library >
• Home > Handbook > 

Last Updated

17/05/2025

Common Design Patterns at Stripe 

By: Paul Asjes

Stripe: 06/07/2024

Designing APIs for Humans Series' Articles by Paul Asjes (Stripe Dev)

• Object IDs
• Error messages
• Design patterns
• Common design patterns at Stripe

Examples

$pi = $stripe->paymentIntents->create([
  'amount' => 1000,
  'currency' => 'usd',
  // Without prefixes, we'd have to supply a 'type'
  'payment_method' => [
    'type' => 'card',
    'id' => '1LaRQ7GUcADgqoEMV11wEUxU'
  ],
]);