Stripe 연결

Stripe를 통한 온라인 결제 수락: 카드, Apple Pay, Google Pay.

1. 개요#

Stripe는 글로벌 결제 플랫폼입니다. Cenaly 레지스트리에서 Stripe는 46개국에서 연결할 수 있습니다. Cenaly + Stripe 통합을 통해 다음이 가능합니다:

• 💳 결제 수락 — 카드(Visa, Mastercard, AmEx)
• 📱 Apple Pay / Google Pay — 한 번의 터치로 결제
• 💰 정산금 수령 — 은행 계좌로 입금
• 🔄 환불 처리 — 관리자 패널에서 처리
• 💵 팁 — 손님이 결제 시 팁 추가
• 📊 보고서 — 완전한 재무 분석

2. 요구 사항#

• ✅ Cenaly 계정 (온라인 결제는 무료 요금제를 포함한 모든 요금제에서 사용 가능)
• ✅ Stripe 계정 (stripe.com에서 무료 가입)
• ✅ 정산금 수령용 은행 계좌 (해당 국가 통화)
• ✅ 인증용 서류 (여권 / ID, 회사 서류)

지원 국가#

Stripe는 46개국에서 연결할 수 있습니다:

3. Stripe 계정 생성#

단계 1. 가입#

1. stripe.com으로 이동 → Start now
2. 이메일을 입력하고 비밀번호 생성
3. 이메일 인증

단계 2. 비즈니스 인증#

Stripe가 요청하는 항목:

인증은 보통 1–3 영업일이 소요됩니다.

단계 3. API 키 발급#

1. Stripe 대시보드에서: Developers → API keys
2. 복사:
   • Publishable key (pk_live_...)
   • Secret key (sk_live_...)

4. Cenaly 연결#

귀하의 Stripe 계정을 연결합니다: 손님의 결제 금액은 귀하의 Stripe 잔액으로 직접 들어가며, Meni는 이를 보관하지 않습니다.

앱 스토어 → "금융" 카테고리 → Stripe 카드 → "설정" 을 여세요 — 연결 블록이 스토어 내에서 모달로 열립니다. 기존 경로도 작동합니다: 지점 → 지점 카드 → "결제" 탭 ("손님 결제" 섹션), Stripe 카드의 "연결" 버튼.

연결 마법사 (권장)#

단계별 마법사(약 10분)가 Stripe 대시보드에서 어디를 눌러야 하는지 보여주며 전체 과정을 안내합니다:

1. 모드 선택 — 테스트 또는 실운영. Stripe의 모드와 Meni의 "테스트 / 실운영" 전환이 일치해야 합니다.
2. 키 복사 — Developers → API keys: Secret key(sk_test_… / sk_live_…)는 필수, Publishable key(pk_…)는 선택 사항입니다.
3. 웹훅 추가 — Developers → Webhooks → Add endpoint, Endpoint URL 필드에 마법사가 "복사" 버튼으로 제공하는 Cenaly 웹훅 주소를 붙여넣으세요. 웹훅이 없으면 Stripe가 주문 결제 완료를 알리지 못하고, 주문이 "대기 중" 상태로 남을 수 있습니다.
4. 이벤트 선택 — "Select events" 블록에서 checkout.session.completed를 반드시 추가하세요(이것이 주문 결제를 확인합니다). 지연 결제 수단의 경우 checkout.session.async_payment_succeeded와 checkout.session.async_payment_failed도 추가하세요. 그런 다음 "Add endpoint"를 누르세요. 이 이벤트들이 없으면 웹훅은 생성되지만 결제를 알리지 않습니다.
5. Webhook signing secret 복사 (whsec_…) — 선택 필드이지만, 이를 입력하면 알림 서명 검증이 활성화됩니다.
6. 연결 — 입력한 값이 보안 백엔드로 전송됩니다.

간단 양식#

Stripe에서 무엇이 어디에 있는지 이미 알고 있다면, 인라인 연결 양식을 열고 동일한 필드를 작성하세요: Secret key, Webhook signing secret(선택), Publishable key(선택) 및 모드 전환.

5. 결제 수단 설정#

신용카드#

Stripe 연결 시 자동으로 활성화됩니다:

• Visa / Mastercard — 모든 국가
• American Express — 대부분의 국가
• Diners Club / Discover — 일부 국가

Apple Pay 및 Google Pay#

Meni에는 이들을 위한 별도 토글이 없습니다: 결제는 Stripe Checkout 호스팅 페이지에서 이루어지므로, 지갑은 Stripe 측에서 활성화됩니다.

• Google Pay — Stripe 연결 후 바로 작동합니다 (Android, Chrome).
• Apple Pay — Stripe는 도메인 확인을 요구합니다: Settings → Payment methods → Apple Pay → Add new domain. 인증 후 iOS/Safari에서 버튼이 나타납니다.

기타 결제 수단#

Stripe Dashboard를 통해 활성화할 수 있습니다:

Stripe Dashboard → Settings → Payment methods에서 필요한 결제 수단을 활성화하세요.

6. 팁#

설정#

1. 지점 → 지점 카드 → "일반" 탭 → "팁" 토글.
2. 작동 방식:

손님에게 보이는 화면#

메뉴 선택 후 결제 시:

주문 내역: 45₾

팁을 추가하시겠습니까?
[ 10% (4.50₾) ] [ 15% (6.75₾) ] [ 20% (9.00₾) ] [ 다른 금액 ]
[ 팁 없음 ]

합계: 49.50₾   [결제하기 →]

팁 보고서#

재무 섹션:

• "개요" 탭 — 기간별 총 팁 금액과 이전 기간 대비 비교;
• "매출" 탭 — 서버별 팁 내역.

7. 계좌 입금#

Stripe의 입금 처리 방식#

손님 결제 → Stripe 보류 → T+2일 후 → 귀하의 계좌에 입금

일정 설정#

Stripe Dashboard → Settings → Payouts에서:

• 매일 (권장)
• 매주 (특정 요일)
• 매월

8. Stripe 수수료#

9. 환불#

Stripe를 통한 환불은 주문이 어떻게 처리되었는지에 따라 두 곳에서 시작됩니다.

인터넷 상점 환불 (RMA)#

1. 반품 섹션 → 요청 카드.
2. 환불 모드를 선택하세요: 원래 결제 수단으로 (Stripe), 기프트 카드(store credit) 또는 교환.
3. 항목을 선택하고(전체 또는 부분 환불) 상품을 창고로 반품할지 결정하세요.
4. 환불은 해당 페이지에서 바로 처리되며, 손님의 카드에는 보통 5–10 영업일 내에 입금됩니다.

POS에서의 환불#

POS에서는 영수증 기준으로 환불이 처리됩니다 — 전체 또는 부분 환불이 가능하며, 재판매를 통한 교환도 있습니다. 이때 현금 교대가 열려 있어야 합니다.

주문 섹션의 주문 카드에서 처리된 환불 배지와 요청 링크를 확인할 수 있습니다.

10. 보안#

PCI DSS#

• Meni는 카드 데이터를 저장하지 않습니다 — 모든 처리는 Stripe가 담당합니다
• Stripe는 PCI Level 1(최고 등급) 인증을 받았습니다
• 카드 데이터는 암호화되고 토큰화됩니다

3D Secure#

• EU 카드에 대한 자동 3D Secure 검증 (SCA/PSD2)
• 사기 및 차지백을 줄입니다
• 손님의 경우: 은행 앱에서 확인

Radar (사기 방지)#

Stripe Radar는 의심스러운 거래를 자동으로 차단합니다:

• 비정상적인 구매 패턴
• 블랙리스트에 등록된 카드
• 위치 기반 이상 징후

11. 테스트#

프로덕션에 적용하기 전에 테스트하세요:

Stripe 테스트 카드#

CVV: 임의의 3자리 숫자. 날짜: 임의의 미래 날짜. ZIP: 임의의 값.

테스트 방법#

1. 연결 시 "테스트 모드" 스위치를 선택하세요 (각 제공업체마다 별도로 설정됩니다).
2. 테스트 키(pk_test_..., sk_test_...)를 사용하세요 — 그리고 동일한 Stripe 테스트 모드에서 생성된 웹훅도 함께 사용하세요.
3. 테스트 주문을 생성 → 테스트 카드로 결제하세요.
4. 주문 섹션에서 주문 상태를 확인하세요 — "결제 완료"로 표시되어야 합니다.
5. 모든 것이 정상 작동하면 "실제 운영" 모드에서 실제 키로 제공업체를 다시 연결하세요.

12. 대체 결제 제공업체#

Stripe를 사용할 수 없는 국가 또는 추가 수단으로, 바로 연결할 수 있는 제공업체입니다:

추가로 94개 제공업체(Adyen, PayTR, ЮKassa, LiqPay, Mercado Pago, Razorpay 등)가 이미 목록에 있지만 회색으로 표시됩니다 — 통합이 아직 테스트 중입니다. 전체 개요는 결제 섹션에서 확인할 수 있습니다.

모든 제공업체 연결 방법: 앱 스토어 → «금융» 카테고리 → 제공업체 카드 → «설정», 또는 익숙한 경로인 지점 → 지점 카드 → «결제» 탭을 이용합니다.

13. 자주 묻는 질문#

언제 돈을 받나요?#

결제 후 2영업일(T+2)입니다. 첫 지급은 7–14일이 걸릴 수 있습니다(Stripe가 계정을 검증하는 동안).

고객이 현금으로 결제하려고 합니다 — 어떻게 해야 하나요?#

«현금» 및 «수령 시 카드» 결제 수단은 항상 사용할 수 있으며 결제 제공업체가 필요하지 않습니다 — 고객이 체크아웃에서 선택하고 계산원이 결제를 처리합니다. 이 경우 Stripe는 사용되지 않으며, 재정 등록기를 연결한 경우 영수증은 POS에서 발행됩니다(재정화 참조).

Stripe와 BOG iPay를 모두 연결할 수 있나요?#

네. «결제» 탭에서 여러 제공업체를 동시에 활성화할 수 있습니다 — 체크아웃에서 고객은 제공업체 이름이 표시된 각 버튼을 보게 됩니다.

Stripe가 계정을 차단했습니다 — 어떻게 해야 하나요?#

1. 이메일을 확인하세요 — Stripe가 사유를 보냅니다
2. 일반적으로 추가 검증이 필요합니다
3. Stripe Support에 문의하세요: support.stripe.com
4. 차단 기간 동안 대체 제공업체를 사용할 수 있습니다

수수료를 최소화하려면 어떻게 하나요?#

• EU 카드 결제를 장려하세요(2.9% 대신 1.5%)
• 큰 금액에는 SEPA를 사용하세요(0.35€ 고정)
• 거래량이 많으면(>100K€/월) Stripe에 개별 요금제를 요청하세요

14. 지원#

• Stripe: support.stripe.com
• Cenaly: support@cenaly.com → 제목 «Stripe / 결제»
• Stripe Status: status.stripe.com(작동 상태 확인)