Ogone

중요

As of January 1, 2026, Worldline, the company behind the Ogone payment solution, no longer supports Ogone. Users of the Ogone payment provider in Odoo should migrate to Worldline.

OgoneIngenico 결제 서비스 라고도 알려져 있으며, 프랑스에 기반을 두고 전자 거래와 관련된 기술을 제공하는 회사입니다.

경고

결제 방법으로 Ogone는 더 이상 사용되지 않습니다. 대신 Stripe 를 사용하는 것을 권장합니다.

Ogone 설정하기

API 사용자 만들기

Ogone 계정에 로그인한 후 환경 설정 탭으로 이동합니다.

Odoo에서 트랜잭션을 생성하는 데 사용할 API 사용자 를 생성해야 합니다. 기본 계정을 사용할 수도 있지만 API 사용자 를 사용하면 Odoo에서 사용된 자격 증명이 유출된 경우 Ogone 구성에 액세스할 수 없습니다. 또한 API 사용자 의 비밀번호는 일반 사용자와 달리 정기적으로 업데이트할 필요가 없습니다.

API 사용자 를 생성하려면 환경 설정 ‣ 사용자 로 이동하여 새 사용자 를 클릭합니다. 다음 필드를 설정해야 합니다.

  • 사용자 ID: 선택한 아이디를 입력합니다.

  • 사용자 이름, 이메일 및 시간대: 선택한 내용을 입력합니다.

  • 프로필: 관리자 로 설정해야 합니다.

  • API용 특수 사용자: 확인 후 입력합니다.

사용자 생성이 완료되었으면, 이제 비밀번호를 생성해야 합니다. 비밀번호와 사용자 ID 는 이후 설정을 하는 동안 필요하므로 반드시 저장하도록 합니다.

이미 사용자 정보가 생성되어 있는 경우에는 활성화했을 때 오류가 없는지 확인합니다. 또는 간단히 활성화 (오류) 버튼으로 사용자를 초기화합니다.

Odoo용 Ogone 설정하기

이제 Odoo에서 결제를 수락하도록 Ogone을 설정해야 합니다. 환경 설정 ‣ 기술 정보 ‣ 글로벌 보안 매개변수 로 이동하여 SHA-512해시 알고리즘 으로, UTF-8문자 인코딩 으로 선택합니다. 그런 다음 같은 페이지의 데이터 및 출처 확인 탭으로 이동하여 전자 상거래 및 별칭 게이트웨이 섹션의 URL 필드를 비워 둡니다.

Odoo 내에서 sha-1 또는 sha-256 과 같은 다른 알고리즘을 사용해야 하는 경우 개발자 모드 를 활성화하고 회계 ‣ 환경 설정 ‣ 결제대행업체 에서 결제대행업체 페이지로 이동합니다. Ogone 을 클릭하고 자격 증명 탭의 해시 함수 에서 사용하려는 알고리즘을 선택합니다.

이제 SHA-IN 암호를 생성해야 합니다. SHA-INSHA-OUT 암호는 Odoo와 Ogone 간에 트랜젝션을 요청하거나 응답할 경우 디지털 서명을 하기 위해 사용합니다. 이러한 비밀번호 구문과 ‘sha-1’ 알고리즘을 사용하여 두 시스템 모두 상대로부터 받은 정보가 변경되거나 변조되지 않았다는 것을 보장할 수 있습니다.

동일한 SHA-IN 암호를 이커머스 및 별칭 게이트웨이 확인DirectLink 및 배치 확인 (자동) 에 입력합니다. IP 주소 항목의 경우에는 입력하지 않고 비워 둘 수 있습니다.

SHA-INSHA-OUT 는 각기 다른 암호를 사용해야 하며 16자에서 32자 사이의 길이여야 합니다. Odoo에서는 SHA-INSHA-OUT 를 하나씩만 사용할 수 있으므로 전체 Ogone 설정에서 SHA-INSHA-OUT 암호는 동일해야 합니다.

SHA-OUT 키를 검색하려면 Ogone 계정에 로그인하여 환경 설정 ‣ 기술 정보 ‣ 트랜젝션 피드백 ‣ 모든 트랜젝션 제출 모드 로 이동하여 API 키클라이언트 키 를 가져오거나 생성합니다. API 키는 나중에 복사할 수 없으며 새로 생성하는 방법밖에 없으므로 반드시 키를 복사해 두세요.

모든 작업이 완료되면 환경 설정 ‣ 기술 정보 ‣ 트랜젝션 피드백 으로 이동하여 다음과 같은 선택 항목을 확인합니다.

  • 브라우저 HTTP 리디렉션 에 대한 URL 항목은 입력하지 않고 비워둘 수 있으며, Odoo에서 이와 같이 트랜젝션 요청이 있을 경우 이러한 URL을 지정하게 됩니다.

  • 리디렉션 URL에 대한 트랜젝션 피드백 매개변수를 받습니다: 를 선택합니다.

  • HTTP 서버 간 직접 요청: 온라인으로 진행되며 온라인 요청이 실패하면 지연된 요청으로 전환 으로 설정합니다.

  • 두 가지 URL 항목에는 모두 <example> 이 있는 동일한 URL이 https://<example>/payment/ogone/return 과 같이 포함되어야 하며 데이터베이스로 대체됩니다.

  • 동적 전자상거래 매개변수 에는 ALIAS, AMOUNT, CARDNO, CN, CURRENCY, IP, NCERROR ORDERID, PAYID, PM, STATUS, TRXDATE. 값이 있어야 합니다. 다른 매개변수도 포함할 수 있지만 (Ogone에서 통합할 다른 항목에 필요한 매개변수가 있는 경우), 권장하지는 않습니다.

  • 모든 트랜잭션 제출 모드 섹션에 SHA-OUT 암호 문구를 입력한 후 상태 변경용 HTTP 요청 을 비활성화합니다.

고객이 나중에 사용할 수 있도록 신용 카드 자격 증명을 저장할 수 있도록 하려면 환경 설정 ‣ 별칭 ‣ 내 별칭 정보 로 이동합니다. 이 탭에서는 사용자의 카드 정보 저장 방법, 정보 저장 기간, 카드 정보 저장 확인란 표시 여부 등을 설정할 수 있습니다.

Odoo에서 설정하기

Odoo에서 Ogone을 설정하려면 회계 ‣ 환경 설정 ‣ 결제대행업체 로 이동하여 Ogone 제공업체를 엽니다. 자격 증명 탭에서 Ogone 계정의 PSPID 를 입력하고 나머지 필드를 Ogone 포털 에 설정한 대로 입력합니다.