새 계정을 만든 후 다음 단계를 사용하여 회사 정보를 추가하십시오.

여기에서 지정하는 주소는 다음 두 가지 목표를 갖습니다.

같은 페이지에서 모든 시스템 디스플레이에 사용할 시간대를 선택할 수도 있습니다. 이 설정은 분석 그래프에 영향을 미칩니다. 그러나 청구 주기 계산은 UTC 시간에 따라 계산됩니다.

3scale은 멤버와 관리자에게 SSO(Single Sign-On) 인증을 지원합니다.

3scale 관리 포털에서는 다음 SSO 공급자를 지원하며, 각각 여러 ID 브로커 및 멤버 페더레이션 옵션을 지원합니다.

RH-SSO 또는 Auth0에 추가된 사용자만 SSO를 통해 3scale 관리 포털에 액세스할 수 있습니다. 역할 또는 사용자 그룹에 의한 액세스를 추가로 제한하려면 RH-SSO 또는 Auth0 지원 포털에 대한 단계별 자습서를 통해 해당 단계를 참조해야 합니다.

선택한 공급자를 통해 SSO를 설정하고 3scale 관리 포털에서 활성화해야 합니다.

SSO를 구성한 후에는 연결된 IdP의 계정 자격 증명을 사용하여 멤버에 로그인할 수 있습니다.

다음 단계에 따라 SSO를 사용하여 3scale 관리 포털에 로그인합니다.

성공적으로 등록하면 API 공급자 조직에 멤버 계정이 생성되고 자동으로 로그인됩니다.

이 섹션에서는 RH-SSO를 통해 IdM(Identity Provider) 로그인 창으로의 리디렉션을 설명합니다. 3scale API Management 관리자는 선택적 SSO(Single Sign-On) 로그인 페이지를 통해 3scale 계정에 액세스할 수 있도록 다음 단계를 완료합니다.

3scale 설치 사용자 목록을 보려면 관리 포털 페이지에서 다음 단계를 따르십시오.

사용자 목록에서 새 팀 구성원을 초대할 수 있습니다. 초대를 보내려면 다음을 수행합니다.

초대 이메일은 입력한 주소로 전송됩니다. 이메일이 도착하지 않으면 수신자의 이메일 계정에 스팸으로 표시되지 않았는지 확인하십시오.

또한 사용자 > 초대장 에서 전송된 초대 목록 및 상태를 확인할 수 있습니다.

새 관리자 또는 멤버가 초대 이메일의 링크를 클릭하고 양식을 작성하여 프로세스를 완료해야 합니다. 양식을 제출하면 해당 계정이 활성화됩니다.

팀 구성원에게 부여할 수 있는 두 가지 주요 권리 유형은 다음과 같습니다.

새 사용자에게 권한을 부여하려면 사용자 메뉴에서 새 사용자를 선택하고 Edit (편집). 다음과 같은 사용자 역할이 있습니다.

관리 포털의 특정 영역에 대한 액세스 권한을 부여하면 멤버가 동등한 API에만 액세스할 수 있습니다.

알림에는 다양한 유형이 있습니다.

관리자 사용자는 모든 알림에 액세스할 수 있습니다.

멤버 사용자는 액세스 권한이 부여된 영역에 대한 알림에만 액세스할 수 있습니다. 예를 들어, 회원은 청구 섹션에 액세스할 수 있는 경우에만 청구와 관련된 알림에 액세스할 수 있습니다.

기업 계정 의 경우 멤버 사용자는 액세스 권한이 부여된 서비스 활동과 관련된 알림에만 액세스할 수 있습니다.

서브스크립션은 개인용이며 알림을 받는 사람만 수정할 수 있습니다. 서브스크립션을 편집하려면 다음을 수행합니다.

이메일 알림 외에도 대시보드의 마지막 활동에 대한 정보를 확인할 수 있습니다.

액세스 토큰을 사용하면 API 공급자 관리자와 멤버가 3scale API(Billing, Account Management, Analytics)에 대해 인증하고 ActiveDocs(대화형 문서)를 사용하여 사용해 볼 수 있습니다.

액세스 토큰은 읽기 및 쓰기 액세스 또는 읽기 전용을 제공할 수 있습니다.

고려해야 할 중요한 점은 액세스 토큰이 작동하는 방식이며 이는 회원의 권리에 따라 다릅니다. 관리자는 3scale API 모두에 대해 인증을 위해 토큰을 만들 수 있습니다. 회원은 관리 포털의 다양한 부분에 액세스할 수 있는 권한에 의해 제한됩니다. 예를 들어, 멤버가 Billing 영역에 액세스할 수 없는 경우 Billing API에 대해 인증할 토큰을 만들 수 없습니다.

액세스 토큰은 토큰 페이지에서 생성할 수 있습니다. 토큰을 생성하려면 다음 단계를 따르십시오.

구성원인 경우 계정의 관리자가 액세스한 API만 모두 표시되지 않을 수 있습니다.

필요한 만큼 액세스 토큰을 생성할 수 있습니다. 보안상의 이유로 토큰은 3scale에 저장되지 않습니다. 새 토큰을 만들 때 토큰을 저장하도록 경고 메시지가 표시되므로 3scale API에 요청할 수 있습니다.

토큰이 손실된 경우 해당 토큰을 삭제하면 비활성화되고 유효하지 않게 렌더링된 후 새 토큰을 생성하는 것이 좋습니다.

액세스 토큰을 사용하여 3scale API에 대한 호출을 수행할 때 액세스 권한이 있는 서비스에서 결과가 필터링됩니다.

예를 들어 APIcast 셀프 관리를 배포할 때 APIcast API 게이트웨이가 계정 관리 API를 사용하여 서비스의 구성을 가져올 수 있도록 액세스 토큰이 필요합니다.

이 기능이 작동하는 방식은 조직이 3scale에 세 개의 서비스를 설정했으며 멤버로서 Service 1에 액세스할 수 있지만 2 및 3이 아닌 경우, 계정 관리 API에도 액세스할 수 있으며, 토큰을 생성하고 계정 관리 API에 요청하면 Service 1을 사용하는 애플리케이션만 가져옵니다.

동일한 예제에 따라 계정 관리 API에 액세스할 수 있지만 서비스 0개에 액세스할 수 있는 경우 호출할 때 "access denied" 오류가 표시됩니다.

관리자는 일부 필수 필드도 건너뛸 수 있습니다. 사용자를 계정에 안전하게 초대하려면 암호 필드를 건너뛸 수도 있습니다. 그러나 이 기본 admin 계정의 이메일은 모든 사용자 간에 고유해야 합니다.

계정의 앱 키를 미리 구성하려면 개발자 대신 애플리케이션을 추가할 수도 있습니다. 그렇지 않으면 개발자가 수행할 초기 단계 중 하나로 그대로 둡니다.

수동으로 이메일 초대를 보내거나 단계에 따라 초대 개발자 기능을 사용할 수 있습니다.

사용자가 (관리자)인 경우 개발자 중 한 명에게 승인 대기 중인 항목이 있는 이메일 알림을 수신하면 해당 항목의 URL을 브라우저에 복사/붙여넣을 수 있으며, 승인하기 위해 페이지로 직접 이동하게 됩니다.

특정 계정을 검색하거나 "보류 중"(승인 중) 상태인 모든 계정을 필터링하려면 대상 > 계정 > 목록으로 이동합니다. 보류 중인 계정만 표시하려면 드롭다운 목록에서 "Pending(보류 중)"을 선택하고 Search (검색)를 클릭합니다.

각 행에서 개별 승인을 직접 수행하거나 한 번에 여러 행을 선택하고 대규모 승인을 수행할 수 있습니다.

서비스에 대한 특정 서브스크립션을 검색하거나 "보류 중"(승인 중) 상태인 모든 서브스크립션을 필터링하려면 대상 > 계정 > 서브스크립션으로 이동합니다.

서브스크립션을 보려면 대상 > 계정 > 사용 규칙 에서 서비스 계획을 활성화합니다.

한 번에 하나의 서브스크립션 또는 여러 개를 선택하고 대량 승인을 수행할 수 있습니다.

애플리케이션을 검색하거나 "보류 중" 상태인 모든 애플리케이션을 필터링하려면 다음을 수행합니다.

한 번에 하나의 애플리케이션 또는 여러 애플리케이션을 선택하고 대규모 승인을 수행할 수 있습니다.

개발자 계정의 세부 정보 페이지에서 시작해서 승인할 애플리케이션을 선택하고 애플리케이션 세부 정보 페이지에 대한 승인을 받을 수도 있습니다.

특정 계정을 검색하거나 필터링하려면 대상 > 계정 > 나열 으로 이동합니다.

한 번에 하나 이상의 행을 선택하고 계획을 변경할 수 있습니다.

서비스에 대한 특정 서브스크립션을 검색하거나 필터링하려면 대상 > 계정 > 서브스크립션으로 이동합니다.

Settings(설정) 페이지에서 서비스 플랜이 활성화된 경우에만 서브스크립션을 볼 수 있습니다.

한 번에 하나 또는 여러 개의 서브스크립션을 선택하고 계획을 변경할 수 있습니다.

특정 애플리케이션을 검색하거나 필터링하려면 대상 > 응용 프로그램 > 나열 으로 이동합니다.

한 번에 하나 또는 여러 애플리케이션을 선택하고 계획을 변경할 수 있습니다.

또 다른 시나리오는 개발자 계정의 세부 정보 페이지에서 시작하는 것입니다. 여기에서 계획을 변경할 애플리케이션을 선택합니다. 애플리케이션 세부 정보 페이지에서 계획을 변경할 수 있습니다.

해당 애플리케이션을 관리하는 계정 및 개발자를 이미 알고 있는 경우 아래 표시된 대로 대상 > 계정 > 목록의 계정 페이지에서 해당 계정으로 이동합니다.

애플리케이션 ID 또는 API 키만 있는 경우 Targetence > Accounts > Listing 의 Accounts(계정) 페이지에서 검색 상자를 사용하여 관련 계정을 찾을 수 있습니다. 애플리케이션 검색에 대한 자세한 내용은 여기에서 확인할 수 있습니다.

아래 표시된 대로 계정 프로필 페이지에 있는 경우 메시지 아이콘을 클릭합니다.

여기에서 만든 메시지는 계정 시스템 대시보드로 모두 전송됩니다. 여기서 계정의 모든 개발자가 볼 수 있으며 계정 내에서 admin 상태가 있는 개발자 계정의 사용자에게 이메일로 전송됩니다.

긴급하고 이메일이 귀하의 목적에 충분히 빠르지 않을 경우 가입 시 개발자가 제출한 연락처 정보를 사용할 수 있습니다.

등록 시 연락처 전화 번호를 필수 입력란으로 지정할 수 있습니다.

관심 있는 개발자 계정의 세부 정보 페이지를 보려면 다음을 수행합니다.

사용자 지정할 계획을 가진 애플리케이션을 선택합니다.

"customize" 옵션을 선택합니다. 이 계정에서 소유한 애플리케이션에 대해 모든 계획 요소를 사용자 지정할 수 있는 페이지를 제공합니다.

애플리케이션을 찾으려면 속하는 계정 이름 또는 애플리케이션 이름이 필요합니다. 이 정보가 없는 경우 액세스 로그를 확인할 수 있습니다. 검색을 수행하려면 Applications(응용 프로그램) (targetence> Applications > Listing) 로 이동합니다.

ID로 인증 유형을 검색하는 경우 다음 정보가 필요합니다.

지정된 애플리케이션을 검색하려면 Applications(애플리케이션) 페이지 (targetence > Applications > Listing) 로 이동하여 아래 이미지와 같이 검색 상자를 사용합니다.

결과가 반환되면 액세스하려는 애플리케이션을 클릭하면 애플리케이션 홈페이지로 이동하게 됩니다. 이 페이지에는 아래 이미지와 같은 정보가 들어 있습니다.

관리 포털을 통해 서브스크립션하는 서비스에서 단일 개발자 구독 해지:

대량 작업을 수행하여 더 이상 사용되지 않거나 삭제된 서비스에서 여러 개발자 구독을 취소합니다.

서비스 계획을 활성화해야 합니다.

계정 또는 애플리케이션 탭에서 애플리케이션을 찾거나 여기에 ??? 설명된 대로 검색할 수 있습니다.

애플리케이션을 찾은 후 애플리케이션 요약 페이지가 표시되면 'State' 값 옆의 일시 중단 아이콘을 클릭합니다. 이 작업은 API에서 애플리케이션을 즉시 비활성화하고 모든 키가 작동하지 않도록 일시 중단합니다. 이러한 애플리케이션 키가 있는 호출은 제어 시스템에서 거부됩니다.

문제가 있는 동작을 수정하면 동일한 버튼을 사용하여 애플리케이션을 중단할 수 있습니다.

애플리케이션 개발자에게 연락하는 방법은 워크플로 및 정책에 따라 달라집니다. 동일한 페이지에서 계정 이름을 클릭하면 애플리케이션을 소유한 계정의 주요 관리자를 식별할 수 있는 계정 보기로 이동할 수 있습니다. 이메일로 문의하거나 표시된 대로 전송 메시지 버튼을 클릭하여 사용자에게 대한 대시보드 메시지를 생성할 수 있습니다.

제품 또는 백엔드에 메서드를 추가하면 개별 사용 세부 정보를 캡처하려는 API에서 메서드를 지정합니다. 애플리케이션 계획에서는 제품 또는 백엔드에 추가하는 각 메서드에 대해 제한을 설정하는 기능을 제공합니다. 메서드 또는 지표를 제품에 추가하는 절차는 백엔드에 메서드 또는 지표를 추가하는 절차와 유사합니다.

지표를 추가하면 API에 대한 모든 호출에 대해 캡처할 사용 단위가 지정됩니다. 애플리케이션 계획에서는 제품 또는 백엔드에 추가하는 각 지표에 대한 제한을 설정하는 기능을 제공합니다. 메서드 또는 지표를 제품에 추가하는 절차는 백엔드에 메서드 또는 지표를 추가하는 절차와 유사합니다.

API에 여러 끝점이 있는 경우 방법을 자동으로 지정하고 3scale 제품 및 백엔드에 지표를 추가하는 두 가지 방법이 있습니다.

매핑 규칙은 제품 및 백엔드에서 이전에 생성된 방법과 지표에 매핑되는 작업입니다.

기본적으로 3scale 계정이 생성되면 다음 두 가지 계획이 제공됩니다. 기본 및 무제한. 계속하고 편집하거나 직접 만들 수 있습니다. 필요한 만큼 많은 계획을 생성할 수 있습니다.

새 애플리케이션 계획을 생성하려면 다음 단계를 따르십시오.

계획을 수립하고 나면 요금 제한을 프로비저닝하고 유료 계획을 설정할 수 있습니다.

모든 플랜을 만든 후 사용자가 애플리케이션을 등록하기 위해 등록할 때 기본 계획을 선택할 수 있습니다.

기본 애플리케이션 계획을 선택하려면 다음을 수행합니다.

기본 애플리케이션 계획을 나타내지 않으면 새 사용자가 API에 대한 액세스를 요청하는 경우 기본적으로 애플리케이션이 생성되지 않습니다. 즉, 사용자는 API에 액세스할 수 없습니다.

첫 번째 결정은 가격 모델에서 계층을 구분하는 방법입니다. 계층은 볼륨 또는 사용량, API 기능, 다른 리소스에 대한 액세스 또는 이러한 계층의 조합으로 구동될 수 있습니다.

가격 드라이버에 대해 결정한 후에는 레벨이 플랫 요금 서브스크립션, 가변 요금, 일회성 초기 요금에 따라 결정되어야 합니다. 위의 세 가지 가격 드라이버는 모두 1오프 또는 월 단순 요금 서브스크립션과 호환됩니다. 가격 결정은 적중량 또는 리소스 소비량에 따라 결정되는 경우 가격 책정에 가변적인 요소가 될 것입니다.

새 애플리케이션 계획을 생성하거나 기존 애플리케이션 계획을 편집할 수 있습니다. 새 애플리케이션 계획을 생성할 때 초기 요금 또는 단순 요금 서브스크립션을 입력할 수 있습니다.

애플리케이션 보기 편집에서는 초기 요금 및 서브스크립션을 입력하거나 수정할 수 있습니다.

다음으로 21.1절. “가격 결정 모델 결정” 에서 선택한 가격 드라이버를 설정합니다.

그 중 일부가 메트릭으로 이미 있는 경우 항목을 편집할 수 있습니다.

가격 규칙 설정을 완료하고 나면 Update Application plan (애플리케이션 계획 업데이트)을 클릭합니다.

단일 애플리케이션 계획을 사용하여 API 유료 계획을 정의할 수 있습니다. 일반적으로 모든 가격 정책 규칙이 볼륨 또는 리소스 드라이버에 의해 정의된 경우 일반적으로 이 사례가 됩니다. 그러나 개발자 커뮤니티의 여러 세그먼트에 대한 별도의 계획을 제공하려면 더 많은 애플리케이션 계획을 추가하십시오.

이 작업을 수행하는 가장 쉬운 방법은 애플리케이션 계획 개요 페이지에서 첫 번째 애플리케이션 계획을 복사하는 것입니다. 이렇게 하면 기존의 모든 지표와 가격 규칙에 미리 채워집니다. 첫 번째 전체 계획을 만드는 데 할애할수록 계획 복사 기능을 사용하면 더 많은 시간을 절약할 수 있습니다.

계획을 프로비저닝하려면 개발자가 새 애플리케이션을 생성하고 새 유료 계획 중 하나를 선택해야 합니다. 관리 콘솔에서 사용자를 대신하여 이 작업을 수행할 수도 있습니다. 기존 애플리케이션의 경우 기존 계획에서 새 유료 계획 중 하나로 변경할 수도 있습니다.

단순 가격 책정 계획과 함께 속도 제한을 사용하여 계층을 구분하는 것이 일반적입니다. 이는 프로비저닝 속도 제한에설명되어 있습니다.

아직 정의된 애플리케이션 계획이 없는 경우 먼저 애플리케이션을 생성합니다. 그렇지 않으면 속도 제한을 설정할 계획을 선택하고 편집을 클릭합니다.

애플리케이션 계획 생성에 대한 자세한 내용은 애플리케이션 계획을 참조하십시오.

속도 제한을 설정하려면 다음을 수행합니다.

이제 요금 제한이 정의되어 있으므로 다음이 수행됩니다.

요금 제한이 운영되면 대시보드의 한도에 도달한 사용자가 잠재적인 계획 업그레이드 후보를 쉽고 빠르게 확인할 수 있습니다. 소프트 및 하드 제한에 대한 자세한 내용은 고급 경로의 애플리케이션 계획으로 API 액세스 정책 구성에서 시작하기 가이드를 참조하십시오.

요금 제한을 설정하는 것 외에도 동일한 메트릭에 대해 가변 가격 규칙을 설정할 수도 있습니다 - 유료 계획 프로비저닝을 참조하십시오.

3scale의 청구는 월별로 계산되며 선불 및 우편료가 될 수 있습니다.

자세한 내용은 Automated billing 프로세스를 참조하십시오.

이 설정은 신용 카드 트랜잭션을 활성화합니다. 이 설정이 켜지면 선택한 결제 게이트웨이를 사용하여 결제한 모든 송장이 청구됩니다. 이 설정을 종료하면 청구가 발생하고 송장이 발행되지만 실제 결제 거래는 발생하지 않습니다.

청구 및 신용 카드 거래가 이루어질 통화를 선택합니다. 결제 게이트웨이에서 선택한 통화를 지원하는지 확인하십시오. 이 설정은 전역적이며 모든 송장 및 트랜잭션에 적용됩니다. 다른 개발자 계정에 대해 다른 통화를 설정할 수 없습니다.

Invoice footnote 필드에 도입된 텍스트가 모든 PDF 송장 하단에 나타납니다. 이 필드를 사용하여 고객에게 청구 및 청구 정책에 대한 추가 정보를 제공할 수 있습니다.

각주 텍스트가 변경되면 PDF가 이미 생성된 송장에 자동으로 적용되지 않습니다. 그러나 송장 PDF를 다시 생성하여 변경 사항을 적용할 수 있습니다.

이 필드는 청구된 계정에 대해 VAT/Sales가 0%인 경우 PDF 송장에 텍스트 메시지를 추가하는 데 사용됩니다. 이 행은 VAT/Sales가 0으로 명시적으로 설정된 경우에만 나타납니다. 그렇지 않으면 표시되지 않습니다. 이 텍스트는 관리 포털의 송장 페이지에도 표시됩니다.

이 설정에 대한 자세한 내용은 VAT / 판매보기 섹션에서 참조하십시오.

currency .yml 파일을 사용하면 3scale 배포에 대한 통화 목록을 구성할 수 있습니다. 3scale은 ISO 4217을 기반으로 하는 3자로 구성된 통화 코드를 사용합니다.

3scale의 송장에는 두 가지 유형의 식별자가 있습니다.

이 설정은 송장 ID의 형식을 정의합니다.

송장 식별자에 대한 청구 기간을 월에서 매년 변경하는 영향은 친숙한 식별자 형식을 변경하는 것입니다. 이 수정은 청구 주기 기간을 변경하지 않습니다. 3scale API Management에서는 월별 청구만 지원합니다. 회계 부서에서 이러한 요구 사항이 있는 경우 송장 설명자를 매년 변경할 수 있습니다.

매년 고객을 청구해야 하는 경우 청구를 수동으로 처리해야 합니다. 새 송장을 작성하고 연간 비용이 포함된 행 항목을 추가할 수 있습니다. 매년 요금을 부과하는 경우, 송장이 생성되지 않거나 매달 자동으로 청구되지 않도록 신청 계획을 무료로 설정할 수도 있습니다.

여기에서 다음 페이지의 경로를 구성할 수 있습니다.

3scale은 신용 카드 거래에 대해 다음과 같은 결제 게이트웨이와 통합됩니다.

온라인 결제 서비스에는 신용 카드 데이터를 수집할 때 규정이 표시되어야 합니다. 위임은 고객이 결제 방법을 지불하도록 제공한 사용 권한의 기록입니다. 규정은 제공된 결제 방법을 사용하여 서비스에 대한 후속 결제를 수집하는 데 명확히 명시해야 합니다. kone 및 Braintree의 지침에 대한 자세한 내용은 추가 리소스 에 나열된 해당 결제 게이트웨이의 외부 문서 링크를 참조하십시오.

3scale API 프로바이더로 사용자 포털과 개발자 포털을 domaine를 신용 카드 게이트웨이로 사용하여 API로의 서브스크립션에서 API로 지불 받을 수 있도록 결제 게이트웨이로 구성합니다.

3scale API 프로바이더로 Braintree를 사용하여 서브스크립션에서 API로의 결제를 받기 위해 Braintree를 사용하여 관리 포털 및 개발자 포털을 구성합니다.

프로시저로 돌아가기.

프로시저로 돌아가기.

프로시저로 돌아가기.

3scale API 프로바이더로서 개발자 포털을 통해 거부된 송장을 결제할 수 있습니다. 이러한 결제를 활성화하려면 관리 포털에서 송장 템플릿을 업데이트합니다. 이 절차는 개발자 포털의 기존 인스턴스를 위한 것입니다.

결제 게이트웨이로 maine 또는 Braintree와 함께 작동하는 3scale API 프로바이더는 이러한 신용 카드 게이트웨이의 일부 문제를 해결할 수 있습니다.

24.5.1. 더 이상 사용되지 않는 결제 게이트웨이

이 섹션에서는 더 이상 사용되지 않는 결제 게이트웨이에 대한 일반적인 정보를 제공합니다. Adyen, OGone 및 Authorize.net. 여기에서 정보는 기존 통합 전용입니다. 이러한 게이트웨이와의 새로운 통합은 지원되지 않습니다.

24.5.1.1. Adyen 통합

중요

Adyen 통합은 더 이상 사용되지 않습니다. 새로운 통합은 지원되지 않습니다. 2019년 8월 22일 이전에 존재하는 통합의 경우 Red Hat은 지원을 제공하지만 완전히 지원되는 결제 게이트웨이 중 하나로 마이그레이션하는 것이 좋습니다. 스트라이프 및 Braintree.

이 단계를 완료하면 계정의 결제 게이트웨이로 Adyen을 구성하게 됩니다. 이렇게 하면 개발자가 신용 카드 세부 정보를 입력할 수 있으며 계산된 송장에 따라 API에 액세스할 수 있도록 Adyen을 통해 자동으로 청구할 수 있습니다.

결제 게이트웨이를 설정하는 것은 신용 카드 결제를 가능하게 하는 중요한 단계입니다. 3scale 계정과 함께 사용할 수 있는 대체 결제 게이트웨이가 많이 있습니다. 여기에서는 Adyen의 단계에 대해 설명합니다.

24.5.1.1.1. 사전 요구 사항

• 이러한 단계를 시작하기 전에 Adyen 으로 계정을 열어야 합니다.
• 회사 계정과 Merchant 계정이 그 안에 있어야 합니다(하위 계정).
• Adyen이 있는 라이브 계정을 신청하려면 이행해야 하는 여러 가지 요구 사항이 있습니다. 여기에서 이러한 요구 사항을 확인할 수 있습니다.
• 계정은 프로덕션 모드에 있어야 합니다.

24.5.1.1.2. Adyen 통합 구성

Adyen 계정에서 정보를 찾습니다.

1. 시작하려면 Adyen 계정에 로그인합니다. 그런 다음 Settings > Users 영역에서 자격 증명을 찾은 다음 다음 보기의 드롭다운 메뉴에서 System 을 선택합니다.

2. 회사 계정( 목록 상단에 있는 계정)을 클릭합니다. 그런 다음 회사 계정 설정 보기로 이동합니다.

3. 마지막으로 로그인,비밀 암호,클라이언트 암호화 공개 키,Merchant ID 및 3scale 청구 설정에 필요한 라이브러리 위치에 액세스할 수 있습니다.
4. 공개 키를 보려면 Generate Password (암호 생성)를 클릭하고 이 암호를 복사해야 합니다.

3scale 계정에 결제 게이트웨이 설정

1. 대상 > 청구 > 청구 및 게이트웨이 에서 상자를 선택하여 청구를 활성화하고 저장을 클릭합니다.
2. Adyen 게이트웨이에 대한 링크를 생성하기 위해 설정해야 하는 모든 필드가 표시됩니다.
3. Gateway (게이트웨이) 드롭다운 메뉴에서 Adyen을 선택하고 변경 사항을 저장해야 합니다.

Adyen API 응답에서 추가 데이터 별칭 활성화

기본적으로 신용 카드 권한 부여 요청이 3scale에서 Adyen으로 전송되는 경우 반환된 응답에는 신용 카드의 고유 식별자가 포함되지 않습니다.

올바른 신용 카드 참조가 3scale에 저장되고 올바른 카드가 청구되도록 하려면 이 추가 데이터를 활성화해야 합니다.

권한 부여 요청에 대한 응답으로 추가 데이터 별칭 을 활성화하려면 Adyen 지원에 문의하십시오.

청구 워크플로 테스트

1. 선불 모드를 활성화하여 1일 이내에 요금을 생성할 수 있도록 테스트 주기를 단축하십시오.

2. 그런 다음 기존 테스트 계정을 선택하고 줄 항목 과금이 추가된 송장을 만듭니다.

   1. 즉시 계정을 청구합니다.
   2. 이 테스트 접근 방식에서는 약간의 비용이 발생하지만 API를 사용하여 개발자에게 실제 비용을 지불하기 전에 모든 것이 제대로 작동하는지에 대해 확신할 만한 가치가 있습니다.

이제 결제 게이트웨이가 설정되었지만 CMS에 구성되지 않았으므로 사용자가 아직 사용하지 못할 수 있습니다. 개발자 포털 탭으로 이동하여 왼쪽 네비게이션 창에서 Payment Gateway / Show 라는 템플릿을 찾습니다.

아직 없는 경우 코드 블록 뒤에 {% when "stripe" %}로 시작하는 코드 블록 뒤에 다음 코드 조각을 추가합니다.

{% when "adyen12" %}
{% if current_account.has_billing_address? %}
  {% adyen12_form %}
{% else %}
  <p><a href="{{ current_account.edit_adyen12_billing_address_url }}">First add a billing address</a></p>
{% endif %}

참고

• 2016년 5월 11일 이전에 생성된 계정의 경우 위의 코드 조각을 수동으로 추가해야 합니다. 이 날짜는 기본적으로 템플릿에 포함됩니다.
• Adyen의 데이터를 3scale의 데이터와 매핑하려면 3scale-[PROVIDER_ID]-[DEVELOPER_ACCOUNT_ID]로 구성된 shopperReference 라는 Adyen 필드를 사용할 수 있습니다.

24.5.1.2. Ogone 통합

중요

Ogone 통합은 더 이상 사용되지 않습니다. 새로운 통합은 지원되지 않습니다. 2018년 7월 27일 이전에 존재하는 통합의 경우 Red Hat은 지원을 제공하지만 완전히 지원되는 결제 게이트웨이 중 하나로 마이그레이션하는 것이 좋습니다. 스트라이프 및 Braintree.

API 사용을 위해 Ogone 게이트웨이를 설정하는 단계입니다.

24.5.1.2.1. 1단계: Ogone에서 API 키 가져오기

Ogone으로 계정을 열어야 합니다. Premium Ogone 전자상거래 계정이 필요합니다. Horizon은 Alias Manager 옵션으로 활성화되었습니다. Ogone 또는 Merchant에서 백오피스 > 옵션 > 옵션을 통해 활성화할 수 있는 유료 옵션입니다.

PSPID는 Ogone 계정에 로그인하는 데 사용됩니다. 그러면 Configuration > Users 에서 UserID를 찾을 수 있습니다.

Ogone 계정의 기술 설정이 활성화되어 있는지 확인합니다. 트랜잭션 피드백 페이지에서 SHA-OUT 암호를 찾을 수 있습니다. 이 페이지에서 두 설정의 확인란이 표시된 대로 표시되는지 확인해야 합니다.

마지막으로 SHA-IN 암호는 날짜 및 원본 확인 페이지에 있습니다.

24.5.1.2.2. 2단계: 3scale로 설정 설정

이러한 API 키를 사용하려면 3scale에 지시해야 합니다. 이렇게 하려면 3scale 관리 포털에 로그인하여 Settings > Billing 으로 이동합니다.

Charging Enabled 플래그가 활성화되어 있지 않으면 활성화한 후 저장을 클릭합니다.

페이지 하단에 Gateway(게이트웨이)라는 드롭다운이 표시되어야 합니다. Ogone으로 변경합니다.

두 필드를 표시하도록 드롭다운 아래의 양식이 변경됩니다. Ogone API 키를 삽입하고 Save(저장)를 클릭합니다.

결제 게이트웨이를 변경할 때 몇 가지 경고가 표시될 수 있습니다. 이 동작은 다음과 같습니다. 표시되는 경우 읽고 수락합니다.

이제 결제 게이트웨이가 설정되었지만 CMS에 구성되지 않았으므로 사용자가 아직 사용하지 못할 수 있습니다. Developer Portal(개발자 포털) 페이지로 이동하여 왼쪽 네비게이션 창에서 Payment Gateway / Show(게이트웨이 / 표시)라는 템플릿을 클릭합니다.

아직 없는 경우 {% 앞에 "braintree_blue" %} 앞에 다음 코드를 추가하십시오.

{% when "ogone" %}
  {% if current_account.has_billing_address? %}
    {% if current_account.credit_card_stored? %}
      {% ogone_form "Edit Credit Card Details" %}
    {% else %}
      {% ogone_form "Add Credit Card Details" %}
    {% endif %}
  {% else %}
    <p><a href="{{ current_account.edit_ogone_billing_address_url }}">First add a billing address</a></p>
  {% endif %}

마지막으로 저장 및 게시를 클릭합니다. 이제 사용자는 Ogone 게이트웨이를 사용하여 결제할 수 있습니다.

24.5.1.2.2.1. 참고

3scale의 데이터를 Ogone의 데이터를 사용자 데이터와 매핑하려면 3scale-[PROVIDER_ID]-[DEVELOPER_ACCOUNT_ID]로 구성된 별칭 이라는 Ogone 필드를 사용할 수 있습니다.

24.5.1.2.2.2. 문제 해결

기능이 작동하지 않는 경우 다음 팁을 확인할 수 있습니다.

• 별칭 관리자와 함께 작동하는 모든 결제 방법의 개요는 이 문서에서 확인할 수 있습니다. 결제 방법 처리/프로세스 개요.
• Ogone 관리 콘솔에서 기술 정보 → 트랜잭션 피드백으로 이동합니다. Directlink/Dynamic Parameters로 스크롤하고 모든 매개 변수를 선택합니다. 이렇게 하면 오류 메시지를 더 쉽게 해결할 수 있습니다(보류 메시지가 송장에 포함됨).
• 3scale 콘솔에서 암호를 변경하고 이 설정을 업데이트하십시오.
• "Special user for API (관리자 없음)" 확인란을 선택하여 Ogone 계정에 사용자가 생성되었는지 확인합니다. 자세한 내용은 Ogone Support FAQ에서 "API 사용자"를 검색할 수도 있습니다.
• Ogone PSPID-account 암호가 아닌 "API 사용자"의 암호를 3scale에 입력해야 합니다.
• Ogone에서 샌드박스 모드를 사용하는 경우 오류가 발생하면 프로덕션으로 변경합니다.

24.5.1.3. Authorize.Net Integration

중요

authorize.Net 통합은 더 이상 사용되지 않습니다. 새로운 통합은 지원되지 않습니다. 2018년 7월 27일 이전에 존재하는 통합의 경우 Red Hat은 지원을 제공하지만 완전히 지원되는 결제 게이트웨이 중 하나로 마이그레이션하는 것이 좋습니다. 스트라이프 및 Braintree.

Authorize.Net 결제 게이트웨이를 Red Hat 3scale 청구 시스템과 통합합니다.

사전 요구 사항

• 유효한 Authorize.Net 계정

• 다음 Authorize.Net 자격 증명

  • API 로그인 ID
  • 트랜잭션 키

3scale API Management를 구성합니다.

1. 3scale 관리 포털에 로그인합니다.
2. 설정 → 청구 페이지로 이동합니다.
3. Basics (기본) 섹션의 드롭다운 메뉴에서 Authorize.Net 을 선택합니다.
4. Authorize.Net Options (인증.Net 옵션) 섹션에서 Authorize.Net API 로그인 ID 및 트랜잭션 키를 입력합니다.
5. Save Changes (변경 사항 저장) 단추를 선택합니다.

가격 규칙은 각 API 요청의 비용을 정의합니다. 동일한 메트릭의 여러 가격 규칙은 가격 규칙이 적용되는 경우 범위를 나눕니다. 가격 규칙은 월별로 기준으로 하며, 카운터는 매월 1일 00:00 UTC로 재설정됩니다.

Until 100 calls per month (from 1 to 100) each API call can be charged at $0.04, and starting from the call 101 (from 101 to infinity) the calls are charged at $0.10.

The first 1000 calls are not charged (cost $0), because they are included in the plan which has a monthly fixed cost. Starting from call 1001, each call is charged at $0.50.

Calls from 1 to 100 are charged at $0.30, 100 to 500 – at $0.40, and 500 and further – at $0.50.

마지막 두 단계를 반복하여 필요한 모든 가격 규칙 범위를 만듭니다.

To 필드를 비워 두어 규칙을 "to infinity"로 설정합니다.

지표 비용의 경우 최대 10진수를 4로 설정합니다. 숫자를 더 많은 10진수로 추가하면 값이 10진수 4개로 반올림됩니다.

대상 > 청구 > 월별 지급(Earning by month ) 섹션에서 결제 내용의 개요를 확인할 수 있으며, 해당 달의 상태에 따라 해당 달에서 발행한 모든 송장의 합계로 계산됩니다.

특정 달을 클릭하면 해당 달의 모든 송장을 나열할 수 있습니다.

대상 > 청구 > 송장 > 송장으로 이동하여 송장 목록도 볼 수 있습니다. 여기에서 해당 ID(소유한 ID), 계정 이름 및 월별 및 상태별로 필터링할 수도 있습니다.

특정 개발자 계정의 송장도 대상 > Accounts > Listing > [selected account] 에서 계정 세부 정보 페이지의 이동 경로 X 송장에 있습니다. 여기서 X는 해당 계정의 송장 수입니다.

송장 목록에서 송장 친숙한 ID를 클릭하면 송장 세부 정보가 표시됩니다.

송장은 다음 상태 중 하나일 수 있습니다.

3scale에서는 청구 프로세스가 매일 실행됩니다. 이 서버는 송장을 생성하고 청구 흐름에 따라 상태를 변경하고 구성된 결제 게이트웨이를 사용하여 요금을 수행합니다.

청구 흐름은 선불 및 Postpaid 모드의 경우 약간 다르며, 3scale의 청구는 월별로 계산되므로 매월 첫째 날 발생하는 특별 이벤트가 있습니다.

자동 청구 프로세스는 유료 서비스에 가입한 모든 개발자 계정에 대한 송장을 생성합니다.

전 세계에 광고가 활성화 또는 비활성화될 수 있습니다. 청구 설정 구성을 참조하십시오. 그러나 개발자 계정당 청구 및 청구를 모두 활성화하거나 비활성화할 수도 있습니다. 이렇게 하려면 계정 페이지로 이동하여 다음을 위해 해당 버튼(활성화/비활성화)을 클릭합니다.

과금이 비활성화되고 청구가 활성화된 경우 개발자는 송장을 발행하지만 청구되지 않습니다. 이는 별도로 비용을 청구하는 경우에 유용합니다(예: 유선 송금).

둘 다 비활성화된 경우 개발자는 발행하거나 청구하지 않습니다.

청구가 비활성화되어 과금이 활성화된 경우 개발자는 새 송장을 발행하지 않지만 모든 미수금(보류 중 및 실패)은 아직 청구됩니다.

여기에서 Billing Status 블록에서 신용 카드 세부 정보가 계정에 구성되어 있는지도 확인할 수 있습니다. 신용 카드 세부 정보가 구성된 경우 월 및 카드 만료 기간이 표시됩니다. 신용 카드 세부 정보가 있으면 가입 및 변경 계획 시 개발자 포털의 흐름에 영향을 줄 수 있습니다( 26.9절. “신용 카드 흐름”에서 자세한 내용 참조).

평가판 기간(일 단위)은 지정된 기간 동안 청구를 지연하도록 결제 계획에 대해 설정할 수 있습니다.

State 열의 애플리케이션 목록([your_product_name] > Applications > Listing)에서 애플리케이션의 시험 기간 상태를 "live - trial expires in N days" 로 표시하고 Trial days left 필드에 있는 애플리케이션 세부 정보 페이지에서 확인할 수 있습니다.

시험 기간 동안 애플리케이션은 제한 없이 플랜에서 정의한 모든 기능과 사용 제한을 사용할 수 있습니다.

시험 기간이 설정되면 취소하거나 확장할 수 없습니다. 다른 계획으로 업그레이드해도 시험 날짜는 재설정되지 않습니다.

시험 기간이 만료되기 10일 전에 향후 평가판 만료에 대해 알리는 이메일 알림이 개발자 계정으로 전송됩니다. 이 이메일의 템플릿은 대상 > 메시지 > 이메일 템플릿에서 구성 할 수 있습니다 : "애플리케이션 평가판 기간 만료" 는 애플리케이션 계획의 경우 만료되었으며, 평가판 기간의 서비스 플랜에 대해서는 "서비스 시험 기간이 만료되었습니다. 개발자는 현재 계획을 그대로 유지하거나 다른 계획으로 전환하거나 서브스크립션을 취소하기로 결정한 경우 API 공급자에게 문의해야 합니다.

시험 기간이 끝나면 다음 시간 자동 청구 실행( 26.4절. “자동 청구 프로세스”참조) 개발자는 애플리케이션 또는 서비스가 현재 있는 계획에 설정된 비용에 따라 청구됩니다. 시험 기간이 만료된 후에도 애플리케이션이 차단되거나 일시 중단 되지 않으며 계속 작동합니다.

무료 계획에 대해 시험 기간을 설정할 수 있지만, 기능이 유용하지 않으므로 사용하지 않는 것이 좋습니다.

VAT(부가 가치 부여)는 유럽 연합 내에서 판매되는 상품과 서비스에 적용되는 세금입니다. 다른 국가에서는 판매세와 같은 유사한 세금이 있습니다. 고객에게 API 서비스 사용을 청구하는 API 공급자는 종종 세금을 청구하고 기존 규정을 준수하기 위해 송장에 반영해야 하는 경우가 많습니다.

3scale 청구는 구성된 경우 송장에 자동으로 VAT를 포함할 수 있습니다.

_Total cost (without <VAT rate>)_ +
_<VAT rate> Amount_ +
_Total cost (<VAT rate> <VAT rate value>% included)_

개발자는 신용 카드 정보를 관리하고 개발자 포털에서 송장을 볼 수 있습니다.

개발자가 개발자 포털에서 청구 관련 요소를 볼 수 있도록 대상 > 개발자 포털에서 재무부서 전환 > 기능 가시성 이 눈에 띄게 표시되어야 합니다.

로그인한 사용자는 Settings > Credit Card Details 에서 신용 카드 세부 정보를 업데이트할 수 있습니다. 구성된 결제 게이트웨이에 따라 양식이 다를 수 있으며 사용자가 먼저 청구 주소를 입력해야 할 수도 있습니다.

개발자는 개발자 포털에 하나의 신용 카드 카드만 사용할 수 있습니다.

개발자 포털에서 신용 카드 세부 정보를 삭제할 수 없습니다. 신용 카드 세부 정보를 삭제하려는 개발자 계정의 사용자는 시스템에서 신용 카드 세부 정보를 삭제하도록 API 프로바이더에게 요청해야 합니다.

송장을 보려면 Settings > Invoices 로 이동하여 각 송장에 대한 세부 정보를 표시하거나 송장 PDF를 다운로드할 수 있습니다.

개발자가 개발자 포털의 신용 카드 세부 정보에 청구 주소를 입력하면 이 주소는 "법적" 계정 주소와 별도로 저장됩니다.

기본적으로, issued to 필드에 있는 Invoices에 법적 주소가 나타납니다. 그러나 개발자에게 법적 주소가 구성되어 있지 않은 경우 청구 주소만 있는 경우 송장에 후자가 사용됩니다. 이 경우 조직 이름은 주소의 일부로 간주됩니다.

기본적으로 청구 주소는 관리 포털 또는 제품 API를 통해 볼 수 없지만 다음과 같이 추가할 수 있습니다.

이제 계정 관리 API 및 Webhook의 계정 XML 모델에 <billing_address> 필드가 표시됩니다. 청구 주소는 계정 및 관리 포털의 계정 편집 페이지에 읽기 전용으로 표시됩니다.

신용 카드 세부 정보 섹션의 개발자 포털에 있는 개발자가 청구 주소를 변경할 수 있습니다. 관리자는 관리 포털의 청구 주소를 변경할 수 없지만 다음 필드("추가 필드"로 ) 를 사용하여 Account Management API의 Account Management 끝점에서 이를 수행할 수 있습니다.

billing_address_name
billing_address_address1
billing_address_address2
billing_address_country
billing_address_city
billing_address_state
billing_address_zip
billing_address_phone

3scale 계정 사용자( 청구 권한이 있는 관리자 및 구성원)는 청구 섹션 아래의 계정 설정(오른쪽 상단에 있는 기어 아이콘) > 개인 > 알림 기본 설정에서 청구와 관련된 알림에 가입하거나 구독 해지할 수 있습니다.

참고: 3scale 계정의 모든 관리자 사용자에게는 청구에 대한 알림이 수신됩니다(해당하는 경우).

개발자 계정으로 전송된 이메일 알림은 대상 > 메시지 > 이메일 템플릿에서 구성할 수 있습니다. 다음 이메일을 사용할 수 있습니다.

개발자 계정의 모든 관리자 사용자에게는 위의 알림이 수신됩니다.

3scale은 API 제품 통계에 대해 무한히 확장 가능한 데이터 리포지토리 역할을 합니다. API에 대한 액세스를 최적으로 관리하는 데 필요한 정보를 보유하도록 메트릭과 메서드를 사용하여 API 제품 통계를 캡처할 수 있습니다. 예를 들면 다음과 같습니다.

API 제품과 관련된 더 많은 지표를 추적할 수 있습니다. 3scale은 시간이 지남에 따라 늘릴 수 있는 수량을 계산할 수 있는 한 임의 개수의 메트릭과 방법을 추적할 수 있습니다.

사용할 지표를 선택한 후 제품 및 백엔드에 지표 추가에 설명된 절차를 사용하여 관리 포털에 등록합니다.

선택한 제품 또는 백엔드에 메트릭과 메서드를 추가할 수 있습니다. 플러그 인 구성에 3scale이 사용하는 친숙한 이름과 시스템 이름을 제공합니다. 메서드 및 지표 생성에 대한 자세한 내용은 방법 지정 및 사용 세부 정보 캡처를 위한 지표 추가를 참조하십시오.

추적하려는 지표의 이름으로 3scale이 준비되면 해당 지표를 보고하도록 플러그인을 구성해야 합니다. 이 작업을 수행하는 정확한 방법은 사용 중인 플러그인 또는 통합 방법에 따라 다릅니다. 기본적으로 플러그인은 Hits, API 트랜잭션, 지표만 보고합니다.

다른 엔드포인트에 대한 자세한 내용은 계정 설정 > 통합 → 3scale API 문서 의 관리 포털에서 3scale API 문서를 참조하십시오.

백엔드로 구성된 지정된 API의 트래픽 데이터를 볼 수 있습니다. Traffic(트래픽) 페이지는 엔드포인트에 대한 조회를 표시합니다.

API 및 3scale 간 연결을 설정하여 API 제품에 트래픽을 보내고 API Analytics 대시보드에서 등록하는 것을 확인할 수 있습니다.

Analytics 섹션의 사용 그래프 외에도 Analytics API를 사용하여 분석 데이터에 액세스할 수 있습니다. 3scale 분석 API는 API 제품의 모든 분석 데이터를 XML 또는 JSON 형식으로 추출할 수 있는 유연한 방법입니다.

분석에 액세스하는 추가 방법은 다음과 같습니다.

[your_product_name] > 분석 > 트래픽의 사용량 차트에 트래픽이 표시되지 않는 경우 다음 검사를 수행합니다.

고객이 매주 수천 명의 신규 개발자를 참여시키고 있었습니다. 3scale은 주요 프로비저닝, 등록 워크플로, 이메일 커뮤니케이션과 같은 자동화된 요구 사항을 제공하므로 온보딩의 일부 측면을 해결할 수 있습니다. 그러나 3scale을 사용할 수 없는 것이 있었지만 매우 중요한 것이 있었습니다.

고객이 많은 사람들에게 온보딩하고 있었기 때문에 운영 및 마케팅 팀이 신규 개발자들과 보다 효율적으로 상호 작용할 수 있도록 API와의 참여를 바탕으로 새 개발자를 분류하는 방법이 필요했습니다. 최소한 필요한 세부 정보 수준은 3scale에서 제공하는 기본 제공 분석 툴에서는 이러한 기능을 아직 사용할 수 없었습니다. 그러나 시스템에서 모든 데이터를 사용할 수 있었기 때문에 3scale 계정 및 분석 API를 사용하여 데이터를 추출할 수 있었습니다.

첫째, 얼마나 많은 개발자가 등록했지만 API를 사용한 적이 없는지 알고자 했습니다.

둘째, API를 사용한 개발자를 두 그룹으로 분할하고자 했습니다.

이 정보는 3scale 기본 제공 분석에서 확인할 수 있습니다. 문제는 통합되는 것을 보여주는 보기가 없다는 것이며, 이는 전체 경험을 매우 번거롭게 만드는 것입니다.

애플리케이션 분석을 추출하려면 ActiveDocs를 사용하여 시작합니다. 3scale ActiveDocs는 계정 설정 > 통합 > 3scale API Docs 아래의 관리 포털에서 사용할 수 있습니다. 3scale에는 ActiveDocs로 사용할 수 있는 모든 API가 있으므로 브라우저에서 사용해 볼 수 있습니다. 이를 통해 요구 사항에 가장 잘 부합하는 요청을 찾고, 요청(curl과 유사)을 가져오고 응답을 빠뜨릴 수 있습니다. 다음 그림은 ActiveDocs 예제를 제공합니다.

스크립트에서 분석을 추출할 모든 애플리케이션을 가져오는 API 요청에 대한 ActiveDocs입니다.

ActiveDocs를 사용하면 API의 기능을 신속하게 파악할 수 있습니다. 그런 다음 수행할 작업에 필요한 3개 또는 4개의 요청을 찾고 스크립트를 함께 배치하는 것이 중요합니다.

다음 절차에서는 예제에서 고객이 원하는 사용자 지정 분석을 수행하는 단계를 보여줍니다.