결제 단말기 통합

이 문서의 주제:

• 소개
• 구성
  • 결제 단말기 공급자 구성
  • 충전 인프라 설정
  • 로밍 요금제
• 충전 세션 제어

소개

이 문서는 Tridens EV Charge에서 OCPI 또는 OICP 통신 프로토콜을 통한 결제 단말기(POS) 통합을 위한 설정 요구 사항을 설명합니다.

통합은 **Payment Terminal Provider(PTP)**가 충전소 운영자(CPO)의 충전 인프라와 통신하는 것을 포함합니다.
이 문서에서 payment terminal provider라는 용어는 기술적 용어로 사용되며, 덜 기술적인 용어인 POS provider와 동의어로 간주됩니다. Payment Terminal Provider는 OCPI 또는 OICP 프로토콜을 통해 충전 세션 제어 및 관련 데이터 전송을 위한 충전 인프라의 게이트웨이 역할을 합니다. OCPI 프로토콜은 공식적으로 결제 단말기 지원을 제공합니다. OICP의 경우, 하이브리드 개념을 사용할 수 있습니다.

그림 1: 결제 단말기 공급자를 위한 OCPI 통신 토폴로지.

구성

결제 단말기 공급자는 CPO를 위한 Tridens EV Charge 테넌트 환경에서 구성할 수 있습니다. 다음 안내는 결제 단말기 설정 및 통신을 공식적으로 정의하는 OCPI 프로토콜(OCPI 2.2.1부터 표준화됨)에 중점을 둡니다.

결제 단말기 공급자 구성

로밍 Payment Terminal Provider(PTP)를 위한 환경을 구성하려면:

1. 로밍으로 이동:

   • Tridens EV Charge 대시보드의 왼쪽 메뉴에서 Roaming 섹션으로 이동합니다.
   • 이 경우 Roaming Profile은 로밍 네트워크에서 충전 인프라(충전기)의 운영자를 나타냅니다.
   • Roaming Platform은 제3자 결제 단말기 공급자를 나타냅니다.
   • 구성을 제출합니다.

2. 로밍 프로필(CPO) 생성:

   • Roaming Profiles 탭에서 새 프로필을 생성하거나 기존 프로필을 사용합니다.
   • Name & Code: 로밍 프로필을 식별할 이름과 코드를 지정합니다.
   • Type: CPO(충전소 운영자)를 선택합니다.
   • Protocol: OCPI를 선택합니다.
   • Roaming ID: 로밍에서 CPO를 나타낼 세 글자의 대문자 식별자를 입력합니다.
   • 구성을 제출합니다.

3. 로밍 플랫폼(PTP) 생성:

   • 새 Roaming Platform을 생성합니다:
   • Name & Code: 플랫폼을 식별할 값을 지정합니다.
   • Type: **Payment Terminal Provider (PTP)**를 선택합니다.
   • URL: 결제 단말기 공급자의 백오피스 서버 URL을 입력합니다(예: https://your-pos-provider.com/api/ocpi).
   • Country: 결제 단말기 공급자의 원산지 국가를 선택합니다.
   • Connection Initiation: 등록 토큰을 사용하여 어느 쪽에서 OCPI 연결을 시작할지 선택합니다.
   • Credentials Exchange (Token):
     • PTP가 토큰을 제공하는 경우: “I will use token provided by my roaming partner"를 선택하고 필드에 토큰을 입력합니다.
     • CPO가 토큰을 제공하는 경우: “I will provide token to my roaming partner"를 선택하고 Generate를 클릭합니다. 생성된 토큰과 연결 URL을 결제 단말기 공급자에게 공유합니다.

4. 등록:

   • 통신은 등록을 통해 시작되어야 합니다.
   • 자격 증명 등록
     • 파트너의 토큰을 사용한 경우, 선택한 Roaming Platform에서 “Register credentials"를 클릭합니다.
     • 토큰을 제공한 경우, 결제 단말기 공급자가 등록을 시작해야 합니다.
   • 자격 증명 업데이트: 필요 시 “Update credentials"를 사용하여 자격 증명을 재협상합니다.
   • 자격 증명 무효화: “Invalidate credentials"를 사용하여 통신/통합을 중단합니다.

그림 2: OCPI 통신 시퀀스.

충전 인프라 설정

CPO와 PTP가 통신을 시작하면, 결제 단말기 공급자는 CPO의 충전 인프라(Locations, EVSEs, Connectors)를 가져올 수 있습니다. CPO는 인프라를 노출하기 위해 특정 로밍 속성을 채워야 합니다:

• Area: roaming id에 고유 식별자와 phone number를 입력합니다.
• Charger: roaming id에 고유 식별자를 입력하고 roaming 속성을 enabled로 표시합니다.
• Connector: roaming id에 고유 식별자를 입력합니다.

Locations 및 충전 인프라는 결제 단말기 공급자에게 보고(push 모드)되며, 가져오기(pull 모드)도 가능합니다.

로밍 요금제

충전소 운영자로서, 결제 단말기 공급자(PTP)가 시작한 세션에 대한 가격을 나타내기 위해 로밍 요금제를 할당할 수 있습니다. 로밍 요금제를 설정하여 에너지 및 시간에 대한 원하는 가격과 세금을 포함한 임시 결제용 요금제를 만듭니다. 요금제에는 충전 세션 결제 승인에 대한 최대 금액도 포함됩니다.

중요 참고 사항:

• 로밍 요금제는 결제 단말기 공급자가 충전소 운영자에게 지불해야 하는 비용을 계산합니다.
• 이 가격이 최종 고객(EV 운전자)이 실제로 지불하는 금액과 반드시 일치하지는 않습니다.

구성 가이드라인:

1. 로밍 요금제 생성:

   • Roaming -> Roaming Tariffs로 이동합니다.
   • Name과 Code를 입력하여 새 요금제를 추가합니다.
   • Status를 Active로 설정하고 유효 기간을 정의합니다.
   • 제출하여 요금제 정의를 생성합니다.

2. 요금제 상세 추가:

   • 요금제 내에서 Tariff Details를 추가합니다.
   • Recurrency: One-time 또는 Daily 반복을 선택합니다.
   • Priority: 우선순위가 높은 상세가 시간대가 겹칠 경우 낮은 상세를 덮어씁니다.
   • Time Frame: 포함 시작 일시와 제외 종료 일시를 결정합니다. 요금제 상세가 적용될 요일을 선택합니다.
   • Pricing: 평가 지표(에너지, 충전 시간, 주차 시간, 고정, 예약 시간 등)에 대한 가격과 VAT 비율을 설정합니다. 빈 필드는 0으로 처리됩니다.
   • 구성을 제출합니다.

3. 로밍 플랫폼(PTP)에 요금제 할당:

   • Roaming -> Roaming Platforms로 돌아갑니다.
   • 이전에 구성한 결제 단말기 공급자용 Roaming Platform을 편집합니다.
   • 설정 마법사(일반적으로 1단계)에서 **Roaming Tariff**를 할당합니다.
   • 구성을 제출합니다.

4. 충전 인프라에 요금제 할당:

   • Session Settings(Session Rating Profile이라고도 함)가 있는 충전 인프라 레벨로 이동합니다. 이는 다양한 레벨에서 충전 인프라에 할당됩니다.
   • 원하는 범위 레벨에 Roaming Tariff를 할당합니다:
     • Site
     • Operator
     • Charger
   • 구성을 제출합니다.

구성이 완료되면, 이 결제 단말기 공급자와 관련된 새로운 충전 세션의 비용이 이 설정에 따라 계산됩니다. 요금제는 결제 단말기 공급자에게 보고(push 모드)되며, 가져오기(pull 모드)도 가능합니다.

충전 세션 제어

결제 단말기 공급자가 Tridens EV Charge의 충전소 운영자에게 충전 세션 관리를 요청할 수 있는 작업:

• 원격 세션 시작
• 원격 세션 중지

결과 및 중간 충전 세션 작업은 API를 통해 결제 단말기 공급자에게 다시 전달됩니다:

• 세션 시작
• 세션 업데이트
• 세션 종료
• 충전 인프라 상태 변경
• 최종 소비 리포트

세션 진행 상황은 결제 단말기 공급자에게 보고(push 모드)되며, 가져오기(pull 모드)도 가능합니다.