Stripe

  Botpress 챗봇을 기업과 고객 간의 거래를 촉진하는 인기 있는 온라인 결제 플랫폼인 Stripe 과 연결하면 Stripe 에서 결제, 구독, 송장 등을 관리할 수 있습니다.

## 설정 및 구성

통합을 설정하려면 Stripe `apiKey`를 제공해야 합니다. 이 키는 Stripe 대시보드에서 얻을 수 있습니다. 연동이 설정되면 기본 제공 작업을 사용하여 Stripe 데이터를 관리할 수 있습니다.

### 전제 조건

 Botpress Stripe  연동을 활성화하기 전에 다음 사항이 있는지 확인하세요:

- Botpress cloud  계정.
- Stripe 에서 생성된 `apiKey`.

### 통합 활성화

 Botpress 에서 Stripe 연동을 활성화하려면 다음 단계를 따르세요:

1. Botpress  관리자 패널에 액세스합니다.
2. 2. '연동' 섹션으로 이동합니다.
3. Stripe  통합을 찾아 "사용" 또는 "구성"을 클릭합니다.
4. 4. 필수 `apiKey`를 입력합니다.
5. 구성을 저장합니다.

## 사용법

연동이 활성화되면 Botpress 챗봇에서 Stripe 기능을 사용할 수 있습니다. 이 연동 서비스는 Stripe 와 상호 작용하기 위한 여러 가지 작업을 제공합니다. 예를 들어 'createPaymentLink', 'createSubsLink'(구독 결제 링크 생성용), 'listPaymentLinks'(ID 및 URL), 'listProductPrices'(가격에 '정기결제' 속성이 있는 경우 제품은 구독 유형입니다.), 'findPaymentLink'(URL, 반환 ID 기준), `deactivatePaymentLink`(ID 기준) 등이 있습니다. 그리고 고객에 대한 작업, `listCustomers`(이메일별 필터링 옵션), `searchCustomers`(이메일, 이름 또는/및 전화별), `createCustomer` 및 `createOrRetrieveCustomer`(사용자가 이미 존재하는 경우, 이메일이 이미 등록되어 있으면 가져옴). 동일한 이메일을 가진 사용자가 여러 명이면 그 배열을 반환합니다. 존재하지 않으면 생성합니다.)

## 지원되는 이벤트

- **충전 실패**: 이 이벤트는 Stripe 에서 충전이 실패할 때 발생합니다.
- **구독이 삭제됨**: Stripe 에서 구독이 취소/삭제된 경우 발생하는 이벤트입니다.
- **구독 업데이트됨**: 이 이벤트는 Stripe 에서 구독이 업데이트될 때 발생합니다. 예를 들어, 구독이 취소되었지만 즉시 종료되지 않은 경우 `cancel_at_period_end`가 참이 됩니다.
- **인보이스 결제 실패**: Stripe 에서 인보이스 결제가 실패한 경우 발생하는 이벤트입니다.
- **결제 의도 실패**: Stripe 에서 결제 의도가 실패한 경우 발생하는 이벤트입니다.

이러한 이벤트를 통해 챗봇은 Stripe 에서 요금, 결제 및 구독과 관련된 다양한 상황에 대응할 수 있습니다.