사이버소스 통합 결제

이 제품은 누구를 위한 것인가요?

이미 CyberSource 운영 계정을 통해 Hosted Checkout을 실행 중인 가맹점 중 Unified Checkout 으로 마이그레이션하려는 경우, 새로운 CyberSource 계정은 필요하지 않습니다. 기존 운영 가맹점 ID(MID)에 새 서비스를 활성화하고 OpenApply 의 구성을 해당 서비스로 전환하기만 하면 됩니다.

⚠️ OpenApply 에서 CyberSource 모드( Hosted Checkout vs. Unified Checkout )는 사용자 또는 세션별이 아닌 학교 별로 설정됩니다. 이 설정을 변경하는 순간 해당 학교의 모든 학부모는 통합 결제를 사용하게 됩니다. 단계적 배포나 직원 전용 미리보기가 제공되지 않으므로, 이 점을 고려하여 계획을 세우시기 바랍니다.

체크리스트

1. 운영 MID에서 통합 결제, 결제자 인증(3DS) 및 의사 결정 관리자를 활성화하려면 MID 구성 요청을 제출하십시오.
2. 서비스 승인이 완료되면 새 REST API 키를 생성하세요.
3. 트래픽이 적은 시간대에 호스팅 체크아웃 자격 증명을 백업한 다음, 새 키와 의사 결정 관리자 확인란을 사용하여 OpenApply 통합 체크아웃으로 전환하십시오.
4. 통합 결제 웹훅을 설정하세요
5. 실제 거래 한 건으로 유효성을 검사한 후, 전환을 유지하거나 롤백하십시오.

1단계: 서비스 활성화(서비스 사용 설정)

비즈니스 센터에서 지원 → 지원 센터를 엽니다.

Visa Acceptance Solutions 지원 센터가 열립니다. 지원 사례 → MID 구성 요청 으로 이동하세요.

양식에서 ' 서비스 활성화' 만 선택하고 제출해 주십시오.

• 통합 결제(REST API)
• 결제자 인증(3DS)
• 의사결정 관리자 (사기 방지 심사가 필요한 경우)

환경 설정 에서 '프로덕션 만'을 선택하세요. '비공개'는 그대로 두세요.

CyberSource 관련 문의 사항은 CyberSource 지원팀에 직접 문의해 주십시오.

CyberSource는 이 과정을 내부적으로 처리합니다(공개 문서에 따르면 일반적으로 영업일 기준 3일 이내). 2단계에서 생성된 REST 키와 3단계의 Decision Manager 체크박스는 모두 가맹점 계정에서 해당 서비스가 활성화되어 있어야 하므로, 이 승인이 완료될 때까지 런북의 다른 단계는 진행할 수 없습니다.

2단계: 새 REST API 키를 생성하고 저장합니다.

⚠️ 통합 결제 키는 동일한 판매자/프로필에 속하더라도 호스팅 결제 키와 다릅니다 . 호스팅 결제는 보안 승인 액세스 키와 비밀 키를 사용하고, 통합 결제는 별도의 REST API 키(키 ID + 공유 비밀 키)를 사용합니다. 두 키는 비즈니스 센터의 서로 다른 위치에 저장되어 있으며, 서로 호환되지 않습니다.

서비스를 활성화한 후에는 비즈니스 센터 → 결제 구성 → 키 관리 로 이동하십시오.

클릭 후 키 생성 :

Unified Checkout에서 사용하는 REST API에 권장되는 키 유형인 REST - 공유 비밀 키를 선택하십시오.

아래에 있는 기존 SCMP/SOAP 툴킷 옵션(CyberSource에서 지원 종료로 표시함)은 무시하고 "키 생성"을 클릭하십시오.

세대를 확인하세요:

CyberSource는 공유 비밀 키를 한 번만 표시하므로 키 와 공유 비밀 키를 즉시 복사(또는 다운로드)하십시오.

3단계: 호스팅 체크아웃을 백업한 다음 OpenApply 통합 체크아웃으로 전환합니다.

⚠️ 이 단계를 진행하면 학교의 모든 학부모가 즉시 통합 결제(Unified Checkout)로 이동합니다. 모드 설정이 학교 전체에 공유되므로(상단의 경고 참조), 통합 결제로 전환하지 않고는 테스트할 방법이 없습니다. 따라서 이 단계부터 5단계까지는 사용량이 적은 시간대에 한 번에 진행하는 것이 좋습니다.

변경하기 전에 OpenApply 관리자 페이지에서 학교의 결제 설정을 열고 현재 호스팅 결제 구성(판매자 ID, 프로필 ID, 액세스 키, 비밀 키)을 안전한 곳에 기록해 두십시오. 나중에 되돌려야 할 경우를 대비하기 위함입니다.

그런 다음 모드를 통합 결제 로 전환하고 새 값을 입력하세요.

• 판매자 ID : 이전과 동일한 값입니다. 판매자 계정은 변경되지 않습니다.
• 액세스 키 / 비밀 키 : 2단계에서 생성된 키 ID와 공유 비밀 키(호스팅된 체크아웃 액세스 키/비밀 키를 재사용 하지 마십시오 . 2단계의 경고를 참조하십시오.)
• 참고로, 이 모드에서는 프로필 ID가 사라집니다. 프로필 ID는 호스팅 체크아웃 전용 필드이며 통합 체크아웃에서는 사용되지 않습니다.
• 환경 : 라이브 환경을 선택하세요
• 1단계 요청에 포함되어 승인된 경우, 지금 의사 결정 관리자를 통해 화면 거래를 확인하세요(4단계 전에 수행해야 합니다. 웹훅 구독은 설정 시 이 확인란의 설정 내용에 따라 구축됩니다).

4단계: 웹훅 설정

3단계에서 설정한 통합 결제 구성을 먼저 저장하세요. 저장 후 동일한 설정 화면(위 스크린샷의 통합 결제 웹훅 섹션 참조)으로 이동하여 "웹훅 자동 설정"을 클릭합니다. 그러면 암호화된 웹훅 자격 증명이 생성 및 등록되고, 상태 점검이 실행되며, 구독이 생성됩니다. 비즈니스 센터에서 수동으로 설정할 필요가 없습니다.

5단계: 실제 거래 한 건으로 검증한 후, 전환을 유지하거나 롤백합니다.

1. 새 REST 키가 저장되었는지, 그리고 Decision Manager/3DS/웹훅 구독이 프로덕션 MID에서 모두 활성화되었는지 확인하십시오.
2. 실제 소액 거래를 한 번 실행하여 승인이 성공하고 OpenApply 에서 청구/송장 상태가 올바르게 업데이트되는지 확인하십시오.
3. 모든 사항이 정상적으로 확인되었다면, 전환된 내용은 그대로 유지됩니다. 추가 조치는 필요 없으며, 학부모님들은 이제 통합 결제 시스템을 통해 결제하시면 됩니다. 만약 문제가 발견되었다면, 즉시 이전 버전으로 되돌리세요.

롤백: 모드를 호스팅 체크아웃으로 되돌리고 3단계에서 백업한 자격 증명을 복원합니다. 이렇게 하면 학교의 모든 학부모 계정이 즉시 호스팅 체크아웃으로 복원됩니다.