KR
EUR
뒤로

VibeFox Tranzila for WooCommerce — 도움말

요구 사항

WordPress: 6.0 이상.

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

PHP: 8.0 이상.

쇼핑몰 통화: ILS, USD, EUR 또는 GBP. 다른 통화의 경우 체크아웃에서 결제 수단이 숨겨집니다.

Tranzila 단말기: 단말기 이름이 필요합니다. 단말기 비밀번호(TranzilaPW)는 handshake와 WooCommerce에서 하는 환불에 필요합니다. 일부 단말기는 환불을 위해 별도의 신용 비밀번호(CreditPass)도 필요합니다. 단말기 이름과 비밀번호는 Tranzila가 제공합니다. 단말기 설정을 확인하거나 Tranzila 고객지원에 문의하십시오. Tranzila는 공개 샌드박스를 제공하지 않습니다. 테스트를 위해 Tranzila는 별도의 테스트 단말기를 제공합니다. 해당 이름을 단말기 이름으로 입력하십시오.

실제 방문자 IP: 결제 알림은 Tranzila 서버의 IP 주소를 기준으로 확인됩니다. 사이트가 Cloudflare와 같은 프록시나 CDN 뒤에 있는 경우, 웹 서버는 실제 방문자 IP를 PHP(REMOTE_ADDR)에 전달해야 합니다.

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

설치

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

2. Activate를 클릭합니다.

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

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

5. Terminal name (supplier)을 입력하고, handshake 또는 환불을 사용하는 경우 Terminal password (TranzilaPW)도 입력합니다.

6. Notifications는 켜 두고 Trusted IP를 확인합니다. 여기에는 Tranzila가 알림을 보내는 IP 주소가 있어야 합니다. 목록은 Tranzila 고객지원에 확인하십시오.

7. 권장: Tranzila 단말기에서 handshake를 활성화하고, 그곳에서 서버 IP 주소를 허용한 다음, 플러그인에서 Handshake를 켜십시오.

8. Enable/Disable을 켜고 Tranzila 테스트 단말기로 결제를 테스트합니다.

설정

모든 설정은 한 페이지에 있습니다: WooCommerce > Settings > Payments > Tranzila. 필드 위에서 페이지는 단말기 이름이 비어 있을 때(이 경우 체크아웃에서 결제 수단이 숨겨짐), 알림이 꺼져 있거나 Trusted IP가 비어 있을 때(이 경우 결제 완료된 주문은 수동 검토를 위해 보류됨), 단말기 비밀번호 없이 handshake가 켜져 있을 때(결제 페이지를 열 수 없음), 쇼핑몰 통화가 지원되지 않을 때 경고를 표시합니다. 저장할 때 잘못된 단말기 이름이나 잘못된 Trusted IP 항목은 저장되지 않으며, 페이지에 오류가 표시되고 이전 값이 유지됩니다. 허용 범위를 벗어난 숫자는 가장 가까운 허용 값으로 수정됩니다.

General

Enable/Disable: Enable Tranzila Payment Gateway는 결제 수단을 켜거나 끕니다. 기본값: 끔.

Title: 고객이 체크아웃에서 보는 결제 수단 이름. 기본값: Credit Card (Tranzila).

Description: 체크아웃에서 결제 수단 아래에 표시되는 텍스트. 기본값: Pay securely with your credit card on the Tranzila payment page.

Terminal

Terminal name (supplier): Tranzila 단말기 이름(예: myshop). 영문자, 숫자, "-", "_"만 사용할 수 있습니다. 입력되기 전까지 체크아웃에서 결제 수단이 표시되지 않습니다. 테스트할 때는 Tranzila 테스트 단말기의 이름을 입력하십시오.

Terminal password (TranzilaPW): 단말기의 API 비밀번호. handshake와 WooCommerce에서 하는 환불에 필요합니다.

Refund password (CreditPass): 단말기가 신용(환불) 거래에 별도의 비밀번호를 요구하는 경우에만 입력하십시오. 그렇지 않으면 비워 두십시오.

Payment page

Payment page version: iframe에 표시되는 Tranzila 페이지.

Current (iframenew.php): 기본값입니다.
Legacy (iframe.php): Tranzila가 요청한 경우에만 사용하십시오.

Payment page language: Tranzila 페이지의 언어: Site language, Hebrew, English, Russian, Spanish, German, French 또는 Japanese. 기본값: Hebrew. Site language는 방문자의 WordPress 로캘이 이 중 하나인 경우 해당 언어를 사용하고, 그렇지 않으면 English를 사용합니다.

iFrame width (px): 300에서 1200. 기본값: 600. 작은 화면에서는 프레임이 페이지보다 넓어지지 않습니다.

iFrame height (px): 400에서 1500. 기본값: 650.

Max installments: 고객이 결제 페이지에서 선택할 수 있는 최대 할부 개월 수(tashlumim). 최대 36개월입니다. 0 또는 1은 할부 없음을 의미합니다. 기본값: 0. 단말기에서 할부 처리가 허용되어 있어야 합니다.

Handshake: Lock the amount with a handshake token (recommended). 결제 페이지를 열기 전에 쇼핑몰은 주문 금액에 연결된 일회용 토큰을 Tranzila에 요청하므로, 브라우저에서 금액을 변경할 수 없습니다. 단말기 비밀번호, Tranzila 단말기에서 handshake 활성화, 그리고 해당 단말기에서 서버 IP 주소 허용이 필요합니다. 기본값: 끔.

Payment confirmation

Tranzila 알림은 서명되지 않습니다. 주문은 알림이 Trusted IP에서 오고, 주문 키, 단말기, 금액 및 통화가 주문과 일치하는 경우에만 결제 완료로 표시됩니다. handshake가 켜져 있으면 토큰도 해당 주문의 결제 페이지와 일치해야 합니다. 고객이 결제 페이지에서 돌아오는 것만으로는 주문이 결제 완료로 표시되지 않습니다.

Notifications: Confirm payments automatically with Tranzila notifications (notify URL). 기본값: 켬. 알림 URL은 모든 결제와 함께 Tranzila에 전송되므로 Tranzila 단말기에 입력할 필요가 없습니다. 형식은 https://your-site/wc-api/tranzila_p_callback/이며 필드 아래에 표시됩니다. 알림이 꺼져 있으면 결제가 성공한 페이지에서 돌아온 고객의 주문은 보류되며, Tranzila 단말기에서 확인한 후 수동으로 결제를 확인하게 됩니다.

Trusted IP: 알림을 보내는 Tranzila 서버의 IP 주소 또는 CIDR 범위를 쉼표로 구분하여 입력합니다. 기본값: 80.244.170.7. 현재 목록은 Tranzila 고객지원에 확인하십시오. 다른 주소에서 온 알림은 거부됩니다. 이 필드가 비어 있으면 알림을 검증할 수 없습니다. 성공으로 보고된 결제는 수동 검토를 위해 주문을 보류하며, 거절로 보고된 결제는 주문을 변경하지 않습니다.

Advanced

Debug log: Log payment page, notification and refund events는 WooCommerce > Status > Logs에 소스 wcp_tranzila_payment_gateway로 기록합니다. 이 옵션이 꺼져 있어도 오류는 항상 기록됩니다. 비밀번호, 토큰, 고객 데이터는 절대 기록되지 않습니다. 기본값: 끔.

Delete data on uninstall: Delete the settings, logs and Tranzila order data when the plugin is deleted. 기본값: 끔.

체크아웃

고객은 결제 수단(기본값 Credit Card (Tranzila))을 선택하고 Continue to payment를 클릭합니다. 주문은 결제 대기 상태로 생성되며, 고객은 쇼핑몰의 주문 결제 페이지로 이동합니다. 그곳에서 주문 금액(주문 통화 기준), 청구 정보, 주문 상품의 간단한 목록과 함께 Tranzila 결제 페이지가 iframe에 열립니다. 페이지에는 Enter your card details on the secure Tranzila payment page below. If it does not load, click "Proceed to payment".라는 문구가 표시됩니다. 프레임 아래에는 Choose another payment method 링크가 있습니다. 할부가 허용되면 고객은 Tranzila 페이지에서 할부 개월 수를 선택합니다.

결제가 성공하면 Tranzila가 고객을 돌려보내고, 전체 창이 쇼핑몰의 주문 접수 페이지로 이동합니다. 주문은 Tranzila가 알림으로 확인한 후에만 결제 완료로 표시됩니다. 그 전까지 페이지에는 Your payment is being confirmed by Tranzila. You will receive an e-mail as soon as it is confirmed — there is no need to pay again.가 표시됩니다. 주문이 검토를 위해 보류 중이면 Your payment is being reviewed by the store. You will receive an e-mail once it is confirmed.가 표시됩니다.

결제가 거절되거나 취소되면 고객은 The payment was not completed. You have not been charged — please try again or choose another payment method. 메시지와 함께 주문 결제 페이지로 돌아갑니다. Tranzila가 응답 코드를 보고하면 사유와 코드가 추가됩니다. 예를 들어 카드 유효기간이 만료되었다는 내용입니다. 고객은 다시 결제하거나 다른 결제 수단을 선택할 수 있습니다.

결제 페이지를 열 수 없는 경우(예: handshake 실패), 고객에게는 Could not connect to Tranzila. Please try again in a moment.와 같은 짧은 메시지와 Choose another payment method 링크가 표시됩니다. 기술적인 이유는 로그에 기록됩니다.

이 결제 수단은 클래식 체크아웃, 체크아웃 블록, Pay for order 페이지에서 작동합니다. Pay for order 페이지에서는 주문 통화가 지원되는 경우 제공됩니다. WooCommerce High-Performance Order Storage(HPOS)와 호환됩니다.

플러그인은 Tranzila 페이지에서 일회성 카드 결제만 지원합니다. 저장된 카드나 토큰, 구독, 별도의 승인 및 매입(J5), 자체 Bit, Apple Pay 또는 Google Pay 버튼(Tranzila 결제 페이지가 제공하는 항목은 iframe 안에 표시됨)은 지원하지 않으며, Tranzila 인보이스도 지원하지 않습니다.

주문 및 환불

Order statuses

Pending payment: 고객이 결제 페이지로 이동했지만 아직 결제하지 않았거나, Tranzila 알림이 아직 도착하지 않은 상태입니다.

Processing or Completed: 검증된 알림으로 결제가 확인되었습니다. WooCommerce는 배송이 필요 없는 주문에는 Completed를, 그 외에는 Processing을 설정합니다. 주문 메모에는 금액, Tranzila 거래, 승인 번호가 표시되며, 할부가 있는 경우 할부 개월 수도 표시됩니다. 거래 ID는 Tranzila 거래 인덱스입니다.

On hold: 결제는 받았지만 자동으로 승인되지 않았습니다. 금액, 통화 또는 handshake 토큰이 주문과 일치하지 않았거나, Trusted IP가 비어 있어 알림을 검증할 수 없었거나, 알림이 꺼져 있고 고객이 성공한 결제 페이지에서 돌아온 경우입니다. 주문 메모에 이유가 설명되어 있습니다. Tranzila 단말기에서 결제를 확인하고 상태를 수동으로 변경하십시오.

Failed: Tranzila가 결제 대기 중인 주문에 대해 거절된 결제를 보고했습니다. 메모에는 응답 코드와 그 의미가 표시됩니다. 이미 결제된 주문은 절대 Failed로 설정되지 않습니다.

취소된 주문에 대해 결제가 들어오면 주문이 다시 열리고, 배송 전에 재고를 확인하라는 메모가 추가됩니다. 고객이 Pay for order 페이지에서 다른 결제 수단으로 바꾸었지만 여전히 열려 있던 Tranzila 페이지에서 결제한 경우, 주문의 결제 수단은 다시 Tranzila로 설정됩니다. 이미 결제, 완료 또는 환불된 주문에 두 번째 결제가 들어오면 주문은 변경되지 않습니다. 메모는 이를 확인하고 Tranzila 단말기에서 중복 금액을 환불하도록 안내합니다. 같은 거래에 대한 반복 알림은 무시됩니다.

Refunds

주문을 열고 Refund를 클릭한 후 금액을 입력하고 Refund via Credit Card (Tranzila)를 클릭합니다(버튼에는 결제 수단의 제목이 표시됩니다). 전액 환불과 부분 환불을 지원합니다. 환불은 원래 결제에 대한 Tranzila 신용 거래로 처리됩니다. 이 버튼은 단말기 비밀번호가 설정되어 있고, 주문에 승인 번호가 있는 확인된 Tranzila 거래가 있을 때 사용할 수 있습니다. 환불이 성공하면 Tranzila 신용 거래와 함께 주문 메모에 추가됩니다.

Tranzila가 환불을 승인하지 않으면 WooCommerce는 Tranzila declined the refund와 같은 오류를 코드와 함께 표시하며, 환불은 기록되지 않습니다. 현재 설정의 단말기와 다른 단말기(예: 테스트 단말기)에서 결제된 주문은 WooCommerce에서 환불할 수 없으며, 해당 Tranzila 단말기에서 환불해야 합니다. Tranzila 단말기에서 직접 한 환불은 쇼핑몰에 보고되지 않습니다. 필요한 경우 Tranzila 버튼을 사용하지 않고 WooCommerce에서 수동 환불을 생성하십시오.

라이선스 키

이 플러그인은 vibefox.net에서 받은 VibeFox 라이선스 키로 작동합니다. 라이선스 블록은 WooCommerce > Settings > Payments > Tranzila 페이지 상단에 있습니다. 키를 License key에 붙여넣고 Activate를 클릭합니다. 블록에는 상태가 표시되며, 예를 들어 라이선스가 활성화되어 있는 기한과 도메인이 나타납니다. Check now를 사용하여 상태를 다시 확인하고, Change key로 다른 키를 입력하고, Remove key로 이 사이트에서 키를 제거할 수 있습니다. Manage licenses and domains in your account 링크는 vibefox.net 계정을 엽니다.

키 하나는 도메인 하나에서 작동합니다. 사이트에서 키를 제거해도 도메인 슬롯은 확보되지 않습니다. vibefox.net 계정에서 슬롯을 해제하십시오.

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

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

문제 해결

Tranzila does not appear at checkout: 라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지, Terminal name (supplier)이 입력되어 있는지, 쇼핑몰 통화(Pay for order 페이지에서는 주문 통화)가 ILS, USD, EUR 또는 GBP인지 확인하십시오. 설정 페이지는 단말기 이름이 없거나 통화가 지원되지 않을 때 경고를 표시합니다.

The payment went through, but the order stays Pending payment: 알림이 도착하지 않았거나 거부되었습니다. Notifications가 켜져 있는지, 그리고 Trusted IP에 Tranzila가 알림을 보내는 주소가 있는지 확인하십시오. 오류는 항상 WooCommerce > Status > Logs에 소스 wcp_tranzila_payment_gateway로 기록됩니다. IP가 Trusted IP 목록에 없다는 메시지는 Trusted IP 설정 또는 프록시 구성을 수정해야 한다는 의미입니다. 프록시나 CDN 뒤에서는 웹 서버가 실제 방문자 IP를 PHP에 전달해야 합니다.

Notification answers Forbidden: Trusted IP에 없는 IP 주소에서 온 알림입니다.

Notification answers Bad request or Not found: 알림의 주문, 주문 키, 단말기 또는 거래 인덱스가 이 쇼핑몰의 주문과 일치하지 않습니다.

Notification answers Accepted for manual review: Trusted IP가 비어 있어 알림을 검증할 수 없었습니다. 성공한 결제는 주문을 보류합니다. 결제를 자동으로 확인하려면 Trusted IP를 입력하십시오.

Notification answers Busy, retry: 같은 시점에 다른 요청이 주문을 처리하고 있어 알림이 적용되지 않았습니다. Tranzila 단말기에서 결제를 확인하십시오. 주문이 아직 결제를 기다리고 있고 그곳에서 결제가 승인되었다면 상태를 수동으로 변경하십시오.

Some paid orders are On hold: 주문 메모를 읽어 보십시오. 금액, 통화 또는 handshake 토큰이 일치하지 않았거나, 알림을 검증할 수 없었습니다(Trusted IP가 비어 있거나 알림이 꺼져 있음). Tranzila 단말기에서 결제를 확인하고 상태를 수동으로 변경하십시오.

The payment page does not open with the handshake on: 단말기 이름과 비밀번호, Tranzila 단말기에서 handshake가 활성화되어 있는지, 그리고 서버 IP 주소가 그곳에서 허용되어 있는지 확인하십시오. 로그에 이유가 표시됩니다.

Refunds fail: 환불에는 Terminal password (TranzilaPW)가 필요합니다. 일부 단말기는 별도의 신용 비밀번호도 요구하며, 이 경우 Refund password (CreditPass)에 입력하십시오. 다른 단말기에서 결제된 주문은 해당 단말기에서 환불해야 합니다.

Other currencies: 플러그인은 ILS, USD, EUR, GBP를 지원합니다. 개발자는 tranzila_p_currency_map 필터로 목록을 조정할 수 있습니다.

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

제거

플러그인을 비활성화해도 모든 데이터는 유지됩니다. 완전히 제거하려면 비활성화한 후 Plugins 페이지에서 삭제하십시오. 이 플러그인의 라이선스 키와 라이선스 상태는 항상 삭제됩니다. 게이트웨이 설정, 주문에 저장된 Tranzila 데이터, 플러그인 로그(순환된 로그 파일 포함)는 Delete data on uninstall이 켜져 있을 때에만 삭제됩니다. 그렇지 않으면 나중에 다시 설치할 때를 위해 유지됩니다. 기존 주문은 결제 메모와 거래 ID를 그대로 유지합니다.

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