VibeFox Ozow for WooCommerce — 도움말

요구 사항

WordPress: 6.2 이상.

WooCommerce: 8.0 이상, 설치 및 활성화되어 있어야 합니다. WooCommerce가 없으면 플러그인을 활성화할 수 없습니다.

PHP: 8.0 이상.

통화: 남아프리카 랜드(ZAR). 다른 통화에서는 결제 방법이 표시되지 않습니다. Ozow는 소수점 없는 센트 단위로 청구하므로 WooCommerce는 소수점 2자리를 사용해야 합니다.

Ozow 계정: Ozow 가맹점 대시보드에서 확인할 수 있는 Ozow 사이트의 Site Code와 Private Key가 있는 Ozow 가맹점 계정. API Key는 선택 사항이지만 권장됩니다. Ozow는 테스트 결제와 실결제에 같은 Site Code와 키를 사용합니다.

접속 가능한 사이트: Ozow 알림이 도착하려면 사이트가 인터넷에서 접속 가능해야 합니다. 유지 보수 모드, 비밀번호 보호, Ozow를 차단하는 방화벽이 없어야 합니다.

VibeFox 라이선스 키: vibefox.net에서 구매합니다. 키 1개는 도메인 1개에서 사용할 수 있습니다.

설치

1. WordPress에서 Plugins > Add New > Upload Plugin으로 이동하여 플러그인 ZIP 파일을 선택한 뒤 Install Now를 클릭합니다. FTP로 wcp_ozow_pay 폴더를 /wp-content/plugins/에 업로드할 수도 있습니다.

2. Activate를 클릭합니다.

3. 설정을 엽니다: WooCommerce > Settings > Payments > Ozow > Manage. 또는 플러그인 페이지에서 플러그인 이름 아래의 Settings를 클릭합니다.

4. 페이지 상단의 라이선스 블록에 VibeFox 라이선스 키를 입력하고 Activate를 클릭합니다.

5. Ozow 가맹점 대시보드에서 Site Code와 Private Key를, 가능하면 API Key도 입력합니다.

6. Enable/Disable을 켭니다. Test mode를 켠 상태에서 테스트 결제를 진행한 뒤, 실제 결제를 받으려면 테스트 모드를 끕니다.

설정

모든 설정은 한 페이지에 있습니다: WooCommerce > Settings > Payments > Ozow. 입력란 위에서 페이지는 Site Code 또는 Private Key가 없을 때(이 경우 Ozow는 체크아웃에서 숨겨집니다), 쇼핑몰 통화가 ZAR이 아닐 때, WooCommerce가 소수점 2자리를 넘어 사용할 때 경고를 표시합니다. 테스트 모드가 켜져 있는 동안에는 Test mode is on: no real payments are accepted. Do not ship orders paid in test mode.도 표시됩니다. 결제 방법 목록에서는 Site Code와 Private Key를 입력하기 전까지 Ozow가 설정이 필요한 상태로 표시됩니다.

일반

Enable/Disable: Enable Ozow payments는 결제 방법을 켜거나 끕니다. 기본값: 끔.

Title: 고객이 체크아웃에서 보는 결제 방법 이름. 기본값: Instant EFT (Ozow).

Description: 체크아웃에서 결제 방법 아래에 표시되는 텍스트. 기본값: Pay instantly and securely from your South African bank account. You will be redirected to Ozow to choose your bank and approve the payment. 테스트 모드에서는 그 아래에 TEST MODE: no money will be charged. 줄이 추가됩니다.

Ozow 인증 정보

Ozow 가맹점 대시보드(Merchant details / Sites)에서 Site Code, Private Key, API Key를 복사합니다. 이 섹션은 hub.ozow.com의 Ozow 연동 문서로 연결되는 링크를 포함합니다.

Site Code: 결제를 받는 Ozow 사이트의 Site Code. 다른 Site Code에 대한 응답은 거부됩니다.

Private Key: 모든 결제 요청에 서명하고 모든 Ozow 응답을 검증합니다. 비공개로 유지하십시오. 이 키가 없으면 결제 방법이 숨겨지고 Ozow 응답은 전혀 허용되지 않습니다.

API Key (recommended): 선택 사항. API Key가 있으면 성공한 모든 결제는 주문이 결제 완료로 표시되기 전에 Ozow GetTransaction API로도 확인됩니다. API는 같은 금액, 통화, Site Code로 이 주문의 결제가 완료되었다고 보고해야 합니다.

Test mode: Enable Ozow test mode. Ozow는 테스트에도 같은 Site Code와 키를 사용합니다. 결제는 IsTest=true로 생성되며 실제 금액은 이동하지 않습니다. 테스트 모드에서 결제된 주문에는 주문 메모가 붙습니다. 발송하지 마십시오. 실결제를 받으려면 테스트 모드를 끄십시오. 테스트 결제는 실운영 모드에서 주문을 결제 완료로 만들지 않습니다. 기본값: 켬.

결제 알림

알림, 성공, 취소, 오류 URL은 결제할 때마다 Ozow로 전송되므로, Ozow 사이트가 고정 URL로 설정되어 있지 않다면 Ozow 대시보드에서 따로 설정할 것은 없습니다. 이 섹션에는 알림 URL이 표시됩니다. 형식은 https://your-site/wc-api/ozow_pay/?ozow_notify=1과 같습니다. Ozow 사이트에서 고정 URL을 사용하는 경우, 설정에 표시된 그대로 정확히 복사하십시오.

고급

Debug log: Log payment requests and Ozow responses를 켜면 WooCommerce > Status > Logs에 세부 정보가 기록됩니다(소스: wcp_ozow_pay). 오류와 경고는 항상 기록됩니다. 키, 해시, 고객 데이터는 기록되지 않습니다. 기본값: 끔.

Delete data on uninstall: Remove the settings and logs of this plugin when it is deleted (Ozow data saved on orders is kept). 기본값: 끔.

체크아웃

고객은 결제 방법(기본값 Instant EFT (Ozow))을 선택하고 주문을 완료합니다. 플러그인은 ZAR로 표시된 주문 합계에 대한 서명된 요청과 함께 고객을 Ozow 호스팅 결제 페이지로 보냅니다. 은행 명세서의 참조 문구는 Order와 주문 번호입니다(라틴 문자, 숫자, 공백, 하이픈 합쳐서 최대 20자). 고객의 이름은 Ozow에 전달됩니다. Ozow 페이지에서 고객은 남아프리카 은행을 선택하고 뱅킹 앱에서 결제를 승인합니다.

이후 Ozow는 쇼핑몰에 알리고 고객을 되돌려 보냅니다. 두 경우 모두 같은 서명된 응답을 담고 있으며 같은 방식으로 처리되므로, 둘 중 하나가 유실되어도 주문은 업데이트됩니다. 주문은 Ozow가 확인한 후에만 결제 완료로 표시됩니다. 해시가 귀하의 Private Key로 검증되어야 하고, Site Code가 귀하의 것이어야 하며, 응답에 이 주문의 키가 있어야 하고, 금액과 통화가 주문과 일치해야 합니다. API Key를 사용하면 GetTransaction API로도 결제가 확인됩니다.

결제가 성공하면 고객은 주문 접수 페이지로 이동합니다. Ozow가 아직 결제를 확인하지 않았다면 페이지에 We are waiting for Ozow to confirm your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again.가 표시됩니다. 주문이 보류 상태라면 Your Ozow payment was received and is being reviewed by the store. We will contact you if anything is needed.가 표시됩니다.

고객이 Ozow 페이지에서 취소하거나 결제가 실패하면 주문은 Failed가 되고, 고객은 Pay for order 페이지로 돌아가 The Ozow payment was cancelled. You can try again or choose another payment method. 또는 The Ozow payment was not completed. You can try again or choose another payment method. 메시지를 보게 됩니다. 고객은 같은 주문을 다시 결제할 수 있습니다.

이 결제 방법은 클래식 체크아웃, Checkout 블록, Pay for order 페이지에서 작동합니다(ZAR 주문에 한함). WooCommerce High-Performance Order Storage(HPOS)와 호환됩니다.

이 플러그인은 ZAR 단건 결제만 받습니다. WooCommerce에서의 환불, 구독, 저장된 은행 계정이나 토큰화, 관리자 화면에서의 결제 링크 발송은 지원하지 않습니다.

주문

주문 상태

Pending payment: 고객이 Ozow로 이동했지만 아직 결제하지 않았거나, Ozow가 아직 결제를 확인하지 않았습니다.

Processing: 결제가 확인되었습니다. 결제 후의 WooCommerce 기본 상태입니다. 다운로드 가능한 가상 상품만 있는 주문은 Completed가 됩니다. 주문 메모에는 금액과 Ozow 거래 ID, 그리고 결제가 GetTransaction API로 확인되었는지 여부가 표시됩니다. 주문의 거래 ID는 Ozow TransactionId입니다. 테스트 결제에는 TEST MODE — no money was received, do not ship this order. 메모가 붙습니다.

On hold: 주문 메모에 이유가 나옵니다. Ozow 또는 은행이 결제를 조사 중입니다(Ozow가 최종 상태를 보내면 주문이 업데이트됩니다). 결제된 금액이나 통화가 주문과 다릅니다. 이미 취소된 주문에 결제가 들어왔습니다. 또는 API Key를 사용하는 경우 GetTransaction API가 아직 결제를 확인하지 못했거나 결제와 상충합니다. Ozow 대시보드에서 결제를 확인한 후 주문 상태를 변경하십시오. API가 응답하지 못했다면 다음 Ozow 알림이 주문을 완료합니다.

Failed: 고객이 결제를 취소했거나, 결제가 중단되었거나, Ozow가 오류를 보고했습니다. 고객은 주문에서 다시 결제할 수 있습니다.

이미 결제 완료된 주문은 되돌아가지 않으며, 취소되었거나 환불된 주문은 다시 열리지 않습니다. 이미 결제 완료된 주문에 두 번째 결제가 들어오면, 메모가 Ozow 대시보드에서 중복분을 환불하라고 알려 줍니다. 주문이 다른 이유(예: 귀하가 설정한 보류)로 보류 상태라면, 이후 결제는 메모만 추가하며, 주문을 Processing으로 설정하는 것은 귀하가 직접 해야 합니다.

환불

WooCommerce에서의 환불은 지원되지 않습니다. Ozow 가맹점 대시보드에서 결제를 환불하고, WooCommerce에는 환불을 수동으로 기록하십시오.

라이선스 키

이 플러그인은 vibefox.net에서 발급받은 VibeFox 라이선스 키로 작동합니다. 라이선스 블록은 WooCommerce > Settings > Payments > Ozow 상단에 있습니다. 키를 License key에 붙여 넣고 Activate를 클릭하십시오. 블록에는 라이선스 유효 기간이나 도메인 등의 상태가 표시됩니다. Check now로 상태를 다시 확인하고, Change key로 다른 키를 입력하며, Remove key로 이 사이트에서 키를 제거합니다. Manage licenses and domains in your account 링크는 vibefox.net 계정을 엽니다.

키 1개는 도메인 1개에서 사용할 수 있습니다. 사이트에서 키를 제거해도 해당 도메인 슬롯은 해제되지 않습니다. vibefox.net 계정에서 슬롯을 해제하십시오.

활성 키가 없으면 체크아웃에서 고객에게 Ozow가 표시되지 않습니다. 그럼에도 결제가 시작되면 고객은 This payment method is not available. Please choose another one.를 보게 됩니다. 로그인한 쇼핑몰 관리자에게는 (unlicensed — visible to admins only)라는 표시와 함께 결제 방법이 계속 보이므로, 키를 구매하기 전에 플러그인을 설정하고 테스트할 수 있습니다. 플러그인 페이지와 WooCommerce 페이지에 알림이 나타납니다. 기존 주문에는 영향이 없으며, 이미 시작된 결제는 계속 확인됩니다.

라이선스가 만료되어도 플러그인은 계속 작동하지만, 업데이트와 지원을 받으려면 갱신이 필요합니다. 상태는 백그라운드에서 자동으로 다시 확인됩니다.

문제 해결

체크아웃에 Ozow가 나타나지 않음: 라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지, Site Code와 Private Key가 입력되어 있는지, 쇼핑몰 또는 주문 통화가 ZAR인지 확인하십시오. 누락된 항목이 있으면 설정 페이지에 경고가 표시됩니다.

결제는 완료되었지만 주문이 Pending payment 상태로 남아 있음: Ozow 알림이 쇼핑몰에 도달하지 않았고 고객도 돌아오지 않은 상태입니다. 사이트가 인터넷에서 접속 가능한지(유지 보수 모드, 비밀번호 보호, Ozow를 차단하는 방화벽이 없는지) 확인하십시오. Ozow 사이트가 고정 URL로 설정되어 있다면, 알림 URL이 설정에 표시된 것과 정확히 일치하는지 확인하십시오. Debug log를 켜고 WooCommerce > Status > Logs에서 소스 wcp_ozow_pay를 확인하십시오.

알림이 Invalid hash로 응답함: 설정의 Private Key가 응답을 보낸 Ozow 사이트의 것이 아닙니다. Ozow 가맹점 대시보드에서 다시 복사하십시오.

알림이 Unknown site로 응답함: 응답이 다른 Ozow 사이트에서 왔습니다. Site Code를 확인하십시오.

알림이 Order mismatch 또는 Order not found로 응답함: 응답이 이 쇼핑몰의 주문에 속하지 않습니다. 아무것도 변경되지 않습니다.

알림이 Gateway not configured로 응답함: Site Code 또는 Private Key가 없습니다. 입력하십시오. Ozow가 다시 시도할 수 있습니다.

알림이 Order busy로 응답함: 같은 주문에 대한 다른 Ozow 응답이 같은 순간 처리되고 있었습니다. 이 응답은 적용되지 않으며, 다음 알림이나 고객의 복귀 시 적용됩니다.

알림이 Payment not confirmed yet로 응답함: API Key를 사용하는 경우, GetTransaction API가 결제를 확인하지 못했습니다. 주문은 보류 상태가 되며, 다음 알림이 주문을 완료합니다. 계속 보류 상태라면 API Key와 Ozow 대시보드의 결제를 확인하십시오.

고객이 Ozow accepts payments in South African rand (ZAR) only를 봄: 주문이 다른 통화입니다. 이 주문에는 Ozow를 사용할 수 없습니다.

테스트 결제가 주문을 결제 완료로 만들지 않음: 게이트웨이가 실운영 모드입니다. 테스트 결제는 실운영 모드에서 주문을 결제 완료로 만들지 않으며, 주문 메모에 이 내용이 표시됩니다.

결제 후 주문이 On hold 상태임: 주문 메모를 읽고 Ozow 대시보드에서 결제를 확인한 후, 주문을 Processing으로 설정하거나 Ozow에서 결제를 환불하십시오.

라이선스 블록에 오류가 표시됨: 블록의 메시지를 따르십시오. 예를 들어 키가 이미 다른 도메인에서 사용 중이라면 vibefox.net 계정에서 슬롯을 해제하고 Check now를 클릭하십시오. 사이트 주소가 바뀌었다면 Check now를 클릭하여 새 도메인에 키를 활성화하십시오. 라이선스 서버에 연결할 수 없으면 플러그인은 마지막으로 확인된 상태로 계속 작동합니다.

제거

플러그인을 비활성화하면 모든 데이터가 유지됩니다. 완전히 제거하려면 Plugins 페이지에서 비활성화한 후 삭제하십시오. 이 플러그인의 라이선스 키와 라이선스 상태는 항상 삭제됩니다. 게이트웨이 설정, 플러그인의 다른 옵션, 로그는 Delete data on uninstall이 켜져 있을 때에만 삭제됩니다. 그렇지 않으면 나중에 재설치할 때를 위해 남아 있습니다. 기존 주문은 결제 메모와 거래 ID를 유지합니다.

Ozow는 해당 소유자의 상표입니다. 이 플러그인은 Ozow와 제휴하거나 Ozow의 승인을 받은 것이 아닙니다.