20달러 결제 하나로 따라가 보는 Stripe: 요구사항마다 붙은 장치들
20달러짜리 결제 하나가 Stripe를 지나가는 동안 무슨 일이 생길까. 카드 번호를 새지 않게, 재시도에도 두 번 청구되지 않게, 사기를 막고, 1센트도 잃지 않고, 가맹점에 알리고, 블랙프라이데이를 버티게 하는 장치를 Stripe 공식 문서와 엔지니어링 블로그로 하나씩 대조한다. 멱등성 키, 복식부기 원장, 우선순위 로드 셰딩은 표준 라이브러리만 쓴 파이썬 토이 예제로 직접 돌려 본다.
2026-11-04 확인. 출발점은 Instagram 릴스다. 캡션, 영상, 이미지는 옮기지 않았고 링크만 출처로 남긴다. 아래 숫자는 그날 Stripe 공식 문서, 엔지니어링 블로그, 뉴스룸에서 확인한 것만 쓴다. 릴스와 다른 곳은 본문에 표시한다. 토이 예제는 개념을 보여주는 스크립트이고 Stripe의 코드가 아니다. 2017년 레이트 리미터 글, 2023년 Radar 글, 2024년 DocDB 글은 당시 구현을 적은 것이라 지금과 다를 수 있다. Stripe 내부 저장소를 본 것은 아니다.
먼저 결론
결제 하나에는 요구사항이 여섯 개 붙고, 요구사항마다 장치가 다르다. 카드가 새지 않을 것. 재시도에 두 번 청구되지 않을 것. 사기를 막을 것. 1센트도 잃지 않을 것. 가맹점에 알릴 것. 블랙프라이데이를 버틸 것.
카드 번호는 가맹점 서버를 지나지 않는다. Stripe 안에서 평문은 Card Data Vault에서만 다뤄진다. 그 저장소는 나머지 인프라와 분리된 AWS 환경이다. 카드 번호는 저장 시 AES-256으로 암호화되고, 복호화 키는 다른 머신에 있다.
재시도의 이중 청구는 클라이언트가 만든 멱등성 키로 막는다. API v1에서 그 키는 최소 24시간 보존된다.
돈의 정확성은 복식부기 원장이 감시한다. Ledger는 하루 50억 이벤트를 본다. 발행된 트랜잭션은 지우거나 고칠 수 없다.
2025년 블랙프라이데이부터 사이버먼데이까지의 피크는 분당 152,000건 이상이었다. 그 부하의 저장 쪽을 2024년 DocDB 글은 MongoDB Community를 확장한 데이터베이스로 설명하고, 샤드 2,000개 이상에 나뉜다고 적는다. 그 글이 2023년에 대해 적은 가용성은 99.999%다. 99.9999%가 아니다. 같은 BFCM 구간의 API 가용성은 뉴스룸이 99.9999% 초과, 2026 피크 시즌 가이드가 99.999% 초과라고 적는다. 이 글은 더 낮은 쪽을 쓴다.
릴스의 Kafka 규모 수치는 Stripe 문서와 블로그에서 찾지 못해 여기서 반복하지 않는다.
해석. 공통 주제는 실패를 없애는 것이 아니다. 재시도는 일어나고, 웹훅은 두 번, 순서가 뒤바뀌어 도착할 수 있고, 마이그레이션 전환 중 읽기가 실패할 수 있다. 위의 장치는 그 실패를 다시 시도해도 안전하게 만든다. 이 문단은 공개 자료를 읽고 정리한 해석이다. 이 글이 코드를 보고 적은 설명이 아니다.
20달러가 지나가는 길
20달러는 설명용 금액이다. Ledger 글은 아래 계정 이름을 쓴다. 20달러를 측정 예시로 실은 것은 아니다. 토이에서 20달러는 2,000센트다.
카드 번호의 평문
Card Data Vault 안에만 있다
저장 시 AES-256, 키는 다른 머신
API는 평문을 얻지 못한다
설명용 20달러 결제 하나
1. 카드 입력 Stripe 도메인 iframe (Checkout, Stripe.js, Elements)
2. 클릭, 재시도 Idempotency-Key. 첫 응답을 저장하고 재생한다
3. 사기 판정 Radar. 결제 경로 안
특징 1,000개 이상, 100ms 미만
"은행보다 먼저"는 확인하지 못했고, 주장하지 않는다
4. 원장 charge.creation, 그다음 charge.release
복식부기. 청산 계정이 0이 아니면 문제
5. 가맹점 Stripe-Signature. 라이브 모드에서 최대 3일 재시도
순서 보장 없음, 중복 가능
6. 피크 DocDB, 샤드 2,000개 이상
목록 조회를 결제 생성보다 먼저 거절
이 결제와 별도인 경로
7. stripe pay 에이전트는 confirmation_required만 받는다
사람이 확인한 뒤에 송금이 실행된다
| 요구사항 | 장치 | 어디서 확인했나 |
|---|---|---|
| 카드 정보가 가맹점에 남지 않음 | Stripe 도메인 iframe, SAQ A | PCI 가이드, 보안 가이드 |
| 평문이 Stripe 나머지 시스템으로 새지 않음 | Card Data Vault, AES-256, 키 분리, 토큰화 | Security at Stripe |
| 재시도는 한 번만 청구 | Idempotency-Key, 저장된 응답 | 멱등 요청 문서, 오류 처리 문서 |
| 사기를 결제 경로 안에서 가려 냄 | Radar | Radar 글, Radar 페이지 |
| 장부가 어긋나지 않음 | 불변 복식부기 원장 | Ledger 글 |
| 가맹점이 결과를 들음 | 서명된 웹훅 | Webhooks 문서 |
| 피크에서도 결제 생성이 목록 조회에 밀리지 않음 | 샤드, 중요 요청을 우선하는 셰더 | DocDB 글, 2017년 레이트 리미터 글 |
해석. 요구사항마다 장치를 하나씩 짝짓는 것이 이 글의 뼈대다. 짝짓기는 정리이고, 각 칸의 장치는 그 칸의 출처에 있다.
1. 카드가 새지 않게: iframe, CDV, 토큰
Checkout, Stripe.js, Elements는 카드 입력란을 Stripe 도메인 iframe에 띄운다. PCI 가이드와 연동 보안 가이드는 그 입력란 때문에 고객 카드 정보가 가맹점 서버에 닿지 않는다고 설명하고, 이 구성을 SAQ A와 연결한다. 입력란은 가맹점 페이지 안에 보인다. 숫자는 가맹점 서버로 전송되지 않는다.
Card Data Vault는 전담 팀이, 나머지 Stripe 인프라와 분리된 AWS 환경에서 운영한다. API와 웹사이트를 포함한 다른 서비스와 자격 증명을 공유하지 않는다. 접근은 소수 엔지니어로 제한되고 분기마다 검토된다. 보안 문서는 모든 카드 번호가 저장 시 AES-256으로 암호화되고, 복호화 키는 별도 머신에 있으며, PAN은 내부적으로 토큰화된다고 적는다.
"Stripe API조차 카드 번호를 읽지 못한다"는 문장은 문서가 긋는 한계까지 같이 읽어야 한다. 내부 서버와 데몬은 평문 카드 번호를 얻을 수 없다. 정적 허용 목록에 있는 서비스 제공자에게 카드를 보내 달라고 요청할 수만 있다.
해석. 장치는 모든 서비스가 조심한다는 약속이 아니라, 번호를 볼 수 있는 범위를 줄이는 것이다. 가맹점 서버는 경로에서 빠진다. Stripe 안에서도 평문은 볼트에 남고, 다른 서비스는 번호를 받는 대신 허용 목록의 제공자에게 보내 달라고 요청한다.
2. 두 번 청구되지 않게: 멱등성 키
Brandur Leach의 2017년 2월 22일 글은 POST가 어긋나는 길을 세 가지로 적는다. 연결이 실패해 요청이 도착했는지 클라이언트가 모른다. 처리 도중에 실패한다. 서버는 끝났는데 응답이 돌아오다 사라진다. 클라이언트는 뒤의 둘을 구분하지 못하므로 재시도한다. 그 글이 POST에 제시하는 답은 Idempotency-Key 헤더이고, 재시도가 한 번에 몰리지 않도록 지수 백오프에 지터를 더한 클라이언트다. 글은 2017년이다. 아래 헤더 계약은 2026-11-04에 확인한 API 문서다.
API v1에서는 엔드포인트 실행이 시작된 뒤, 첫 요청의 상태 코드와 본문을 저장한다. 같은 키의 재시도는 그 저장된 응답을 돌려주고, 저장된 500도 그대로 돌려준다. 파라미터가 다르면 재시도는 오류다. 검증 실패는 저장하지 않는다. 동시에 실행이 겹친 충돌인 409도 저장하지 않는다. 재생된 응답에는 Idempotent-Replayed: true 헤더가 붙는다. 키는 최대 255자이고, 문서는 UUID v4를 권한다.
v1 키는 최소 24시간 보존된다. 그 뒤 삭제될 수 있고, 삭제된 키를 다시 쓰면 새 요청이 실행된다. 재시도는 그 창 안에 있어야 한다. v2는 재생 방식이 다르고 창이 30일이다. 이 글은 그 이상 v2를 설명하지 않는다.
해석. 응답 유실과 중간 실패를 구분할 수 없으므로, 안전한 클라이언트는 항상 재시도하고 서버는 그 재시도를 무해하게 만들어야 한다. 같은 생각이 웹훅 경계에서 다시 나온다.
3. 사기를 막게: Radar
2023년 3월 29일 글 "How we built it: Stripe Radar"는 2022년 중반 Radar가 XGBoost와 심층 신경망의 앙상블(Wide & Deep)에서 심층 신경망 단독으로 옮겼다고 적는다. 그 망은 ResNeXt에서 가져온 multi-branch 구조다. 학습 시간은 85% 이상 줄었다. 같은 글은 Radar가 1,000개 이상의 특징을 100밀리초 안에 보고, 정상 결제를 잘못 막는 비율이 0.1%이며, 사기는 약 1,000건 중 1건이라고 한다. 2023년 글이 지금 도는 모델을 설명하지 않을 수 있다.
Radar 페이지의 문장은 "Stripe가 전에 본 카드일 가능성 92%"다. "결제의 92%가 이미 본 카드"와 같은 문장이 아니다. 같은 페이지는 데이터 포인트 70조 개 이상, 평균 사기 32% 감소를 적고, 2025년 결제 처리액 1.9조 달러를 다시 적는다.
그 글은 판단을 구매 클릭부터 확인까지의 순간에 둔다. 은행에 승인 요청을 보내기 전에 점수를 낸다고는 말하지 않는다. 이 글은 "결제 경로 안"이라고만 하고, 카드사와의 순서는 주장하지 않는다.
해석. 카드를 이미 본 네트워크는 가맹점이 갖지 못한 이력으로 새 결제를 점수 매길 수 있다. 이것은 가능성 92%와 데이터 포인트 70조를 읽은 해석이지, 별도의 측정이 아니다.
4. 1센트도 잃지 않게: Ledger
Ledger 글은 불변이고 감사 가능한 로그를 설명한다. 발행된 트랜잭션은 삭제하거나 수정할 수 없다. 장부는 복식부기다. 예시 계정은 charge_unsubmitted, charge_undisbursed, business_balance다. 이벤트는 charge.creation과 charge.release다. 청산 계정이 0이 아니면 문제로 본다. Ledger는 하루에 50억 이벤트를 본다. 달러 금액의 99.99%는 4일 안에 수집되고 검증된다. 자금 이동을 설명할 수 있는 비율은 99.9999%를 넘는다. 마지막 숫자는 설명 가능성이지 가용성이 아니다. DocDB 수치도, API 수치도 아니다.
이 글의 20달러 분개는 설명용이다. 계정 이름은 그 글에서 왔고, 금액은 그렇지 않다.
그 글은 Ledger를 생산 시스템의 projection이라고 부른다. 그 시스템들이 내보낸 이벤트로 만든 별도의 모델이고, 돈의 이동을 읽고 검증하는 데 쓴다.
해석. 청산 계정은 파이프에 남아 있는 물이다. charge_undisbursed가 0으로 돌아오는 것을 이 글은 흐름이 빠졌다는 신호로 읽는다. 파이프 그림은 설명이지 인용이 아니다. 그 projection을 CQRS의 읽기 모델로 부르는 것도 해석이다. 여기서 쓰는 정의는 Martin Fowler의 CQRS 노트다. 결제 버그 하나가 로그인까지 멈추게 할 때는 그 정의로 모델 분리와 bulkhead를 나눈다. Ledger 글은 "CQRS"라고 말하지 않는다. oplog를 Kafka와 S3로 복사하는 DocDB 마이그레이션도 같은 모양으로 읽을 수 있다. 그 문장은 해석이다.
5. 가맹점에 알리게: 서명된 웹훅
웹훅에는 Stripe-Signature 헤더가 붙는다. v1 스킴은 타임스탬프가 포함된 페이로드에 대한 HMAC-SHA256이다. 공식 라이브러리의 기본 허용 오차는 5분이고, 이것이 가로챈 서명을 나중에 다시 쓰지 못하게 하는 장치다. 라이브 모드에서는 지수 백오프로 최대 3일 재전송한다. 샌드박스에서는 몇 시간 동안 3회 시도한다. 순서는 보장되지 않는다. 같은 이벤트가 두 번 이상 도착할 수 있고, 문서는 이벤트 ID로 중복을 제거하라고 권한다.
해석. 보내는 쪽은 at-least-once이므로 받는 쪽도 멱등해야 한다. 2절의 규칙을 가맹점 쪽으로 옮긴 것이다.
모든 변경이 이벤트이고 웹훅이 Kafka 위에서 돈다는 주장은 Stripe 1차 출처에서 찾지 못했다. 빼 두었다. 이 아키텍처와 함께 도는 Kafka 규모 수치도 Stripe 문서와 블로그에는 없었다. 그 수치는 컨퍼런스 발표에 있고, 발표는 출처에만 올리며, 이 글은 숫자를 반복하지 않는다. Stripe 자신의 DocDB 글이 말하는 범위는 더 좁다. 마이그레이션 파이프라인이 oplog를 Kafka와 S3로 보낸다는 것이다.
6. 블랙프라이데이를 버티게: DocDB와 로드 셰딩
2025년 12월 2일 뉴스룸은 2025년 블랙프라이데이부터 사이버먼데이까지를 거래 5억 7,800만 건 이상, 총결제액 400억 달러 이상, Stripe 역사상 가장 큰 4일, 사이버먼데이 하루만 100억 달러 이상이라고 적는다. 피크는 분당 152,000건 이상이었다.
그 구간의 API 가용성은 이 글에서 더 낮은 수치를 쓴다. 2026 피크 시즌 가이드는 99.999% 초과라고 적는다. BFCM 뉴스룸은 같은 구간에 99.9999% 초과라고 적는다. Stripe 페이지 둘이 서로 다르므로, 본문은 낮은 쪽을 두고 다른 쪽은 여기에 남긴다.
2024년 6월 6일 글 "How Stripe's document databases supported 99.999% uptime with zero-downtime data migrations"는 Stripe의 DocDB가 MongoDB Community의 확장에 Stripe 자체 서비스를 더한 것이라고 한다. 초당 500만 쿼리 이상, 쿼리 형태 1만 개 이상, 컬렉션 5,000개 이상, 페타바이트 규모의 데이터가 샤드 2,000개 이상에 나뉜다고 적는다. 제목과 본문의 가용성은 2023년 기준 99.999%, 9가 다섯 개다. 99.9999%가 아니다. 이 글이 지금 배포를 설명하지 않을 수 있다.
그 글의 Data Movement Platform은 여섯 단계다. 등록, 벌크 임포트, oplog를 Kafka와 S3로 보내는 비동기 복제, 정합성 검사, 버전 토큰을 쓰는 트래픽 전환, 해제. 전환은 2초 미만이다. 실패한 읽기와 쓰기는 재시도하면 성공한다고 적는다. 2023년 이 플랫폼은 1.5PB를 옮겼고 샤드 수를 약 4분의 3 줄였다. "샤드 2,000개 이상"과 "약 4분의 3"은 둘 다 그 글의 문장이다. 이 글은 둘을 합쳐 파생 샤드 수를 만들지 않는다.
2017년 3월 30일 레이트 리미터 글은 리미터를 네 가지로 설명한다. 요청 속도, 동시 요청, fleet usage 로드 셰더, worker utilization 로드 셰더. fleet usage 셰더는 결제 생성 같은 중요 요청과 결제 목록 같은 비중요 요청을 Redis 클러스터에서 따로 센다. 토큰 버킷이다. 용량의 20%를 예약하면, 비중요 트래픽이 남은 80%를 넘는 순간 비중요 요청은 503을 받는다. 2017년 설계다. 지금의 리미터는 다를 수 있다. 아래 토이는 예약 규칙만 가져온다.
해석. 샤드는 데이터를 나눈다. 셰딩은 용량을 늘리지 않는다. 어떤 요청을 먼저 거절할지 정해서, 목록 조회가 결제 생성보다 먼저 자리를 내놓게 한다. 프로세스 장애가 아니라 용량에 적용한 bulkhead와 같은 직감이다. 그 경계를 다룬 글은 결제 버그 하나가 로그인까지 멈추게 할 때이다. 비유는 이 글의 것이다.
토이 예제로 확인
stripe-one-payment-toy.py는 파이썬 표준 라이브러리만 쓴다. 난수, 시계, 네트워크가 없어서 두 번 실행하면 같은 글이 나온다. Stripe의 코드가 아니다. 시계가 없으므로 키의 24시간 만료는 흉내 내지 않는다. Redis와 토큰 버킷도 흉내 내지 않는다. 공개 글의 규칙 세 가지만 다룬다. 저장된 응답을 재생할 것, 합이 0이 아닌 트랜잭션을 거절할 것, 용량의 일부를 중요 요청을 위해 남겨 둘 것.
아래 세 조각은 그 파일에서 가져왔고, 클래스 본문의 들여쓰기만 걷어 냈다.
def post(self, event, entries):
total = sum(amount for _, amount in entries)
if total != 0:
raise UnbalancedError(f"{event}: entries sum to {total}, not 0")
self.log.append((event, tuple(entries)))
if idempotency_key is not None and idempotency_key in self.saved:
old_params, response = self.saved[idempotency_key]
if old_params != params:
raise ParamMismatch("same key, different parameters")
return dict(response, idempotent_replayed=True)
def admit(self, kind):
used = sum(self.in_flight.values())
if used >= self.capacity:
return 503
if kind == "noncritical" and self.in_flight["noncritical"] >= self.noncritical_cap:
return 503
self.in_flight[kind] += 1
return 200
아래 출력은 2026-11-04에 그 파일을 Python 3.12.3으로 두 번 실행해, 두 번의 바이트가 같음을 확인한 결과다.
== 1. retry after a lost response ($20 = 2000 cents) ==
no key : charges created=2 customer charged=4000 cents replayed=False
with key: charges created=1 customer charged=2000 cents replayed=True
reuse key with 3000 cents -> rejected: same key, different parameters
== 2. double-entry ledger ==
balances: {'business_balance': 2000, 'charge_undisbursed': 0, 'charge_unsubmitted': -2000}
sum of all accounts: 0
rejected: buggy.release: entries sum to -10, not 0
sum after rejected post: 0 | transactions in log: 2
== 3. load shedding: 9 list calls arrive, then 4 create calls (capacity 10) ==
no reserve GET /v1/charges ok=9 503=0 [200, 200, 200, 200, 200, 200, 200, 200, 200]
no reserve POST /v1/charges ok=1 503=3 [200, 503, 503, 503]
20% reserve GET /v1/charges ok=8 503=1 [200, 200, 200, 200, 200, 200, 200, 200, 503]
20% reserve POST /v1/charges ok=2 503=2 [200, 200, 503, 503]
키가 없으면 유실된 응답 뒤에 두 번째 청구가 생기고, 고객은 4,000센트를 낸다. 키가 있으면 청구는 하나 생기고, 고객은 2,000센트를 내며, 재시도는 저장된 응답이다. 같은 키에 3,000센트를 넣으면 거절된다.
charge.creation과 charge.release 뒤 계정 합은 0이다. charge_undisbursed는 다시 0이다. 10센트가 모자란 release는 거절되고, 로그는 트랜잭션 두 건에 머물며, 합은 0으로 남는다.
해석. 토이에서 charge_undisbursed가 0인 것은 이 흐름이 끝났다는 신호다. Ledger 글의 청산 계정 규칙을 설명용 20달러에 적용한 것이다. 셰딩은 열한 번째 칸을 만들지 않는다. 예약이 없으면 목록 조회 아홉 건이 자리를 써서 결제 생성은 하나만 통과하고 나머지 셋은 503이다. 20%를 예약하면 503을 받는 것은 아홉 번째 목록 조회이고, 결제 생성은 두 건이 통과한다. 그 예약을 넘는 결제 생성 두 건은 여전히 503이다. 셰더는 무엇을 먼저 버릴지 고른다. 용량 10을 늘리지는 않는다.
덧붙임: 에이전트가 돈을 보내는 시대, stripe pay
Stripe 공식 X 계정은 2026-10-27 16:43 UTC(한국 시간 2026-10-28 01:43)에 이렇게 올렸다. "Introducing 'stripe pay', for instant business-to-business transfers. Find companies using their Stripe profile handle and send funds for free. Available in the Dashboard and CLI." CLI 레퍼런스는 stripe pay [recipient] [amount] [currency]이고, 통화는 usd, gbp, usdc다.
발표는 "free"와 "instant"라고 말한다. 공식 에이전트 스킬은 "Don't assume that a transfer is free or instant"라고 적는다. CLI는 사용자가 확인하기 전에 수수료와 도착 시점을 보여 준다. 이 글은 스킬을 따른다. 송금을 무료이거나 즉시라고 두지 않는다.
--agent와 --json은 confirmation_required만 돌려준다. 돈을 보내지 않는다. 사용자가 확인한 뒤 --yes와 --financial-account로 다시 실행한다. --dry-run이 있다. 승인 요청은 5분 뒤 만료된다.
해석. 되돌리기 어려운 송금 앞에 확인 단계가 있다. 실패해도, 다시 시도해도 안전하게 만드는 규칙을, 첫 시도에 돈을 보내 버릴 수 있는 에이전트에 적용한 것이다.
릴스 주장 검증표
릴스는 인용하지 않는다. 각 행은 확인해야 했던 주장, 판정, 이 글이 그 주장으로 한 일이다. ✅는 2026-11-04에 Stripe 1차 출처로 확인했다. ⚠️는 출처가 다르거나, 숫자가 설명용이라는 뜻이다. ❓는 찾지 못했고, 사실로 쓰지 않는다. 표가 넓다. 표 안에서 가로로 스크롤하면 된다.
| # | 주장 | 판정 | 이 글이 쓰는 것 |
|---|---|---|---|
| 1 | 처리액 1.9조 달러 | ✅, 연도를 붙임 | 2025년 Stripe 위 처리액 1.9조 달러, 2024년 대비 34%, 세계 GDP의 약 1.6%. 2025 연례 서한은 2026-02-24 발표. Radar 페이지도 2025년 1.9조 달러 |
| 2 | 카드 입력란은 iframe | ✅ | Checkout, Stripe.js, Elements. 카드 정보는 가맹점 서버에 닿지 않음. SAQ A |
| 3 | Card Data Vault는 격리된 AWS | ✅ | 전담 팀, 나머지 인프라와 분리, API·웹사이트와 자격 증명 비공유, 소수 엔지니어, 분기 검토 |
| 4 | AES-256, 키는 다른 머신 | ✅ | 저장 시 AES-256. 복호화 키는 별도 머신. PAN은 내부 토큰 |
| 5 | API도 번호를 읽지 못함 | ✅, 뉘앙스가 있음 | 내부 서버·데몬은 평문을 얻지 못함. 정적 허용 목록의 제공자에게 전송을 요청할 수만 있음 |
| 6 | Idempotency-Key, 저장 응답, 재생 헤더 | ✅ | 실행 시작 후 상태와 본문 저장, 500 포함. 파라미터가 다르면 오류. 검증 실패와 409는 저장 안 함. 재생 시 Idempotent-Replayed: true. 키 최대 255자, UUID v4 권장 |
| 7 | 키를 얼마나 두나 | ✅ | v1은 최소 24시간, 이후 삭제될 수 있음. 삭제 후 재사용은 새 요청. v2는 재생이 다르고 30일 |
| 8 | 설계가 있는 이유 | ✅ | Brandur Leach, 2017-02-22. 연결 실패, 처리 중 실패, 응답 유실. 지수 백오프와 지터 |
| 9 | Radar는 심층 신경망 | ✅ | 2022년 중반, XGBoost+DNN 앙상블(Wide & Deep)에서 DNN 단독, ResNeXt식 multi-branch. 학습 시간 85% 이상 감소 |
| 10 | 신호 1,000개 이상, 100ms 미만 | ✅ | 2023-03-29 글. 정상 결제 오차단 0.1%. 사기는 약 1,000건 중 1건 |
| 11 | 은행에 묻기 전에 점수 | ❓, 빼 둠 | 글은 클릭부터 확인까지의 순간만 말한다. 카드사보다 앞이라는 순서는 찾지 못함. 본문은 "결제 경로 안"만 씀 |
| 12 | 결제의 92%가 본 카드 | ✅, 문구를 바꿈 | 페이지는 본 적 있는 카드일 가능성 92%. 데이터 포인트 70조 이상, 평균 사기 32% 감소 |
| 13 | Ledger는 불변 복식부기 | ✅ | 발행분은 삭제·수정 불가. 계정 charge_unsubmitted, charge_undisbursed, business_balance. 이벤트 charge.creation, charge.release. 청산 계정이 0이 아니면 문제 |
| 14 | 하루 50억 이벤트 | ✅ | 달러 금액의 99.99%를 4일 안에 수집·검증. 자금 이동 설명 가능성은 99.9999% 초과. 가용성 수치가 아님 |
| 15 | −20달러와 +20달러의 합이 0 | ⚠️, 금액은 설명용 | 계정 이름은 글과 같음. 20달러는 이 글의 설명용 금액 |
| 16 | Kafka 클러스터 수와 일일 처리량 | ⚠️, 수치는 생략 | Stripe 문서·블로그에 없음. 컨퍼런스 발표에만 있음. 숫자는 옮기지 않음 |
| 17 | Kafka 가용성 자릿수 | ⚠️, 빼 둠 | Stripe 채널이 아님. 발표 슬라이드의 내부 목표. 숫자는 옮기지 않음 |
| 18 | 웹훅이 Kafka 위에서 동작 | ❓, 빼 둠 | 웹훅 경로가 Kafka라는 1차 출처가 없음 |
| 19 | 서명된 웹훅, 3일 재시도 | ✅ | Stripe-Signature, HMAC-SHA256 v1, 타임스탬프, 기본 허용 5분. 라이브는 최대 3일 재시도. 샌드박스는 몇 시간 동안 3회. 순서 없음, 중복 가능, 이벤트 ID로 제거 |
| 20 | BFCM 2025, 400억 달러 이상 | ✅ | 2025-12-02. 거래 5억 7,800만 건 이상, TPV 400억 달러 이상, 최대 4일, 사이버먼데이 100억 달러 이상 |
| 21 | 분당 152,000건 | ✅ | 피크에 분당 152,000건 이상 |
| 22 | API 가용성 99.9999% | ⚠️, 더 낮은 수치 | 뉴스룸은 99.9999% 초과. 2026 피크 가이드는 99.999% 초과. 이 글은 후자 |
| 23 | DocDB는 MongoDB Community 확장 | ✅ | Stripe 자체 서비스를 더함. 초당 500만 쿼리 이상, 쿼리 형태 1만 이상, 컬렉션 5,000개 이상, 페타바이트 |
| 24 | 샤드 2,000개 이상 | ✅ | 2024-06-06 글 |
| 25 | 무중단 샤드 이동 | ✅ | 6단계. 전환 2초 미만. 실패한 읽기·쓰기는 재시도로 성공. 2023년 1.5PB 이동, 샤드 수 약 4분의 3 감소 |
| 26 | DocDB 제목의 가용성 | ⚠️, 99.999% | 2023년, 제목과 본문. 99.9999%가 아님 |
| 27 | Redis로 세고, 용량 예약, 목록이 먼저 503 | ✅ | 리미터 4종. 예약 20%면 비중요는 80%를 넘을 때 503. 2017-03-30 글, 지금과 다를 수 있음 |
| 28 | stripe pay, 핸들로 | ✅, 실재함 | 공식 X, 2026-10-27 16:43 UTC(2026-10-28 01:43 KST). CLI stripe pay, 통화 usd, gbp, usdc |
| 29 | 무료이고 즉시 | ⚠️, 가정하지 않음 | 발표는 무료·즉시. 공식 스킬은 둘 다 가정하지 말라고 함. CLI가 확인 전에 수수료와 도착을 보여 줌 |
| 30 | 사람이 확인한 뒤에만 실행 | ✅ | --agent와 --json은 confirmation_required만 반환하고 돈을 보내지 않음. 그다음 --yes와 --financial-account. --dry-run. 승인은 5분 뒤 만료 |
내 서비스에 가져갈 것
해석. 더 작은 서비스를 위한 교훈이다. Stripe를 다시 만들라는 요청이 아니다.
결제를 만드는 API와, 두 번 실행되면 안 되는 다른 POST에 멱등성 키를 둔다. 키는 클라이언트의 재시도를 덮을 만큼 오래 두고, 파라미터가 바뀐 재사용은 거절한다.
웹훅 소비자를 멱등으로 만든다. 타임스탬프가 있는 서명 검사는 재전송 공격을 막고, 이벤트 ID는 중복 전달을 막는다. 순서는 여전히 보장되지 않는다.
금액은 정수 센트로 둔다. 합이 0이 아닌 트랜잭션은 거절하고, 청산 계정이 0이 아니면 경보를 낸다. 토이의 10센트 거절은 그 검사지, Stripe가 1센트를 SLO로 발표했다는 뜻이 아니다.
중요 요청과 나머지를 나누고, 중요 요청을 위해 용량을 남겨 둔다. 예약은 서비스를 더 크게 만들지 않는다. 먼저 실패할 요청으로 목록 조회를 고른다.
카드 번호를 자기 서버로 직접 받지 않는다. 호스티드 필드가 더 작은 범위다.
Card Data Vault 격리, 내부 서비스로 운영하는 문서 데이터베이스, 큰 이벤트 버스는 Stripe 규모의 선택이다. 더 작은 시스템이 위 다섯 가지를 쓰려고 그것들을 베낄 필요는 없다.
출처
2026-11-04에 확인했다. 2017년, 2023년, 2024년 글은 지금 구현을 설명하지 않을 수 있다.
- Instagram 릴스. 출처 링크만. 캡션, 영상, 이미지는 쓰지 않았다.
- Stripe 2025 연례 서한. 2025년 처리액 1.9조 달러, 2024년 대비 34%, 세계 GDP의 약 1.6%.
- 뉴스룸, 2025 연례 서한. 2026-02-24 발표.
- Security at Stripe. Card Data Vault, AES-256, 키 분리, 토큰화, 허용 목록.
- 연동 보안 가이드.
- PCI 준수 가이드. iframe과 SAQ A.
- 멱등 요청.
- 고급 오류 처리. 24시간, 30일, Idempotent-Replayed, 409.
- Brandur Leach, 멱등성, 2017-02-22.
- Stripe Radar. 가능성 92%, 데이터 포인트 70조 이상, 평균 사기 32% 감소, 2025년 1.9조 달러.
- Ryan Drapeau, How we built it: Stripe Radar, 2023-03-29.
- Ledger.
- Webhooks.
- 뉴스룸, BFCM 2025, 2025-12-02. 더 높은 API 가용성 수치가 이 페이지에 있고, 이 글은 그 수치를 쓰지 않는다.
- 2026 피크 시즌 준비. API 가용성 99.999% 초과. 이 글이 쓰는 수치.
- DocDB, 99.999% 가용성, 2024-06-06.
- Paul Tarjan, 레이트 리미터, 2017-03-30.
- CLI 레퍼런스, stripe pay.
- 공식 에이전트 스킬, stripe-pay. "Don't assume that a transfer is free or instant."
- 공식 X, stripe pay, 2026-10-27.
- 토이 스크립트. 2026-11-04, Python 3.12.3에서 실행. 위에 인용한 출력.
- 해석에서만 쓰는 용어. Martin Fowler, CQRS, Azure bulkhead.
- 보조. Kafka 규모에 대한 말은 컨퍼런스 발표에 있다. 그 수치는 쓰지 않았다. Kafka Summit London 2022, 슬라이드, Current 2024.