VibeFox Paysera for WooCommerce — 도움말

요구 사항

WordPress: 6.0 이상.

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

PHP: 8.0 이상.

Paysera 프로젝트: Paysera 프로젝트의 프로젝트 ID와 프로젝트 비밀번호(서명 키)가 필요합니다. 고객에게 표시되는 결제 방식은 이 프로젝트에서 활성화된 방식입니다. 콜백을 위해 Paysera에서 별도로 설정할 것은 없습니다. 콜백 URL은 모든 결제 요청과 함께 전송됩니다.

접근 가능한 사이트: 주문은 Paysera 콜백으로 결제 완료 처리되므로, 사이트가 로그인, 유지 보수 모드 또는 방화벽 뒤에 있지 않고 인터넷에서 접근 가능해야 합니다.

VibeFox 라이선스 키: vibefox.net에서 구매합니다. 하나의 키는 하나의 도메인에서만 작동합니다.

설치

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

2. Activate를 클릭합니다.

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

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

5. Paysera 계정의 Project ID와 Project password를 입력합니다(설정 항목 참조).

6. 선택 사항: 금액을 청구하지 않고 흐름을 테스트하려면 Paysera 프로젝트에서 Allow test payments를, 플러그인에서 Test payments를 활성화합니다. 판매를 시작하기 전에 끄십시오.

7. Enable/Disable을 켜고 저장합니다.

설정

모든 설정은 하나의 페이지에 있습니다: WooCommerce > Settings > Payments > Paysera. 필드 위에는 프로젝트 ID 또는 프로젝트 비밀번호 중 하나라도 비어 있으면 프로젝트 ID와 프로젝트 비밀번호를 입력할 때까지 Paysera는 결제 시 숨겨집니다.라는 안내가 표시됩니다. 또한 테스트 결제나 샌드박스가 켜져 있는 동안에는 고객에게 요금이 청구되지 않는다는 알림이 표시됩니다. 결제 방식 목록에서 Paysera는 프로젝트 설정이 완료될 때까지 설정 필요 상태로 표시되며, 테스트 결제나 샌드박스가 켜져 있으면 테스트 모드 배지가 표시됩니다.

일반

Enable/Disable: Enable Paysera Payment는 결제 방식을 켜거나 끕니다. 기본값: 꺼짐.

Title: 결제 시 고객에게 표시되는 결제 방식 이름. 기본값: Paysera.

Description: 결제 시 결제 방식 아래에 표시되는 텍스트. 기본값: Pay securely via Paysera.

Paysera 프로젝트

프로젝트 ID와 프로젝트 비밀번호는 Paysera 계정의 Projects and activities에서 프로젝트를 선택한 후 General project settings에서 확인할 수 있습니다. 이 섹션에는 콜백 URL이 표시되며, 형식은 https://your-site/wc-api/wc_psr_payment/와 같습니다. 이 URL은 모든 결제와 함께 자동으로 전송되므로 Paysera에서 따로 설정할 필요가 없습니다.

Project ID: Paysera 프로젝트의 숫자 ID.

Project password: 프로젝트 비밀번호(서명 키). 결제 요청에 서명하고 Paysera 콜백을 검증하는 데 사용됩니다.

테스트

Test payments: Send payments in test mode (no money is charged). 고객에게 요금을 청구하지 않고 Paysera가 성공한 테스트 결제를 반환합니다. 먼저 Paysera 프로젝트 설정에서 Allow test payments를 활성화하십시오. 이 옵션이 켜져 있는 동안 테스트 결제는 주문을 결제 완료로 처리하며, 꺼져 있으면 테스트 결제는 주문을 결제 완료로 처리하지 않습니다. 기본값: 꺼짐.

Environment: 고객이 이동하는 대상. 일반 Paysera 프로젝트에서는 테스트 결제 시에도 Production을 유지하십시오. 기본값: Production.

고급

Debug log: Log payment events. 오류는 항상 기록됩니다. 로그는 WooCommerce > Status > Logs의 소스 wcp_paysera_payment에 있습니다. 비밀번호와 고객 데이터는 기록되지 않습니다. 기본값: 꺼짐.

Delete data: Delete the plugin settings and logs when the plugin is deleted. 플러그인을 비활성화해도 아무것도 삭제되지 않습니다. 주문 데이터는 항상 유지됩니다. 기본값: 꺼짐.

결제

고객은 결제 방식(기본값 Paysera)을 선택하고 주문을 제출합니다. 테스트 결제가 켜져 있으면 결제 페이지에 테스트 모드 — 요금이 청구되지 않습니다.가 표시됩니다. 플러그인은 주문 통화의 최소 단위로 된 주문 합계, 고객의 이름, 이메일, 청구지 주소가 포함된 서명된 결제 요청을 만들며, 사이트 언어에 따라 언어를 선택합니다(리투아니아어, 라트비아어, 에스토니아어, 러시아어, 독일어, 폴란드어, 그 외에는 영어). 고객은 Paysera 결제 창으로 이동하여 그곳에서 은행, 카드 또는 다른 방식을 선택합니다.

결제 후 고객은 주문 접수 페이지로 돌아갑니다. 주문은 서명된 Paysera 콜백이 도착했을 때에만 결제 완료로 표시되며, 고객이 돌아오는 것만으로는 주문이 결제 완료되지 않습니다.

고객이 Paysera 결제 창에서 취소하면 주문은 WooCommerce 표준 방식으로 취소되며, 고객은 다시 주문할 수 있습니다. 결제를 시작할 수 없는 경우 고객에게 Paysera 결제를 일시적으로 사용할 수 없습니다. 다른 결제 방식을 선택해 주십시오.라는 메시지가 표시됩니다. 원인은 로그에 기록됩니다.

이 결제 방식은 클래식 결제, 결제 블록, Pay for order 페이지에서 작동합니다. WooCommerce 고성능 주문 저장소(HPOS)와 호환됩니다.

이 플러그인은 WooCommerce에서의 환불, 결제 페이지에서의 은행 또는 결제 방식 선택, 구독, 저장된 카드, Paysera 배송 또는 택배 서비스를 지원하지 않습니다.

주문

주문 상태

Pending payment: 고객이 Paysera로 이동했지만 콜백이 아직 도착하지 않았습니다.

Processing: Paysera가 결제를 확인했습니다(상태 1). 다운로드 가능한 가상 상품만 포함된 주문은 WooCommerce 기본값인 완료됨으로 변경됩니다. 주문 메모에는 Paysera 요청과 결제 방식이 표시됩니다. 거래 ID는 Paysera 요청 ID입니다.

On hold: Paysera가 결제 지시를 수락했지만 아직 실행하지 않았습니다(상태 2). Paysera가 결제를 확인하면 주문이 완료됩니다. 또는 결제된 금액이나 통화가 주문과 다릅니다(메모 amount/currency mismatch). 또는 테스트 결제가 꺼져 있는 동안 테스트 결제를 받았기 때문에 요금이 청구되지 않았습니다. 주문 메모에 이유가 설명되어 있습니다.

Cancelled: 고객이 Paysera 결제 창에서 취소했거나, 판매자가 또는 재고 보류 시간 초과로 주문이 취소되었습니다. 취소된 주문에 대해 나중에 확인된 결제는 주문 상태를 바꾸지 않습니다. 메모에서 주문을 복원(Processing으로 설정)하거나 Paysera에서 결제를 환불하라는 안내가 표시됩니다.

기타 Paysera 상태(결제 미실행, 추가 정보 필요)는 메모만 추가합니다. 이미 결제 완료된 주문에 다른 성공 결제가 들어오면 주문은 변경되지 않으며, 메모에서 중복 결제를 Paysera 계정에서 환불하라고 안내합니다.

환불

WooCommerce에서의 환불은 지원되지 않습니다. Paysera 결제 창 프로토콜에 환불 API가 없기 때문입니다. Paysera 계정에서 환불을 진행하십시오. Paysera가 환불을 알리면 환불 금액이 포함된 메모가 주문에 추가되며, 주문 상태는 변경되지 않습니다. 필요한 경우 WooCommerce에서 환불을 수동으로 기록하십시오.

라이선스 키

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

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

유효한 키가 없으면 결제 시 고객에게 Paysera가 표시되지 않습니다. 그럼에도 결제가 시작되면 고객에게 This payment method is not available. Please choose another one.가 표시됩니다. 로그인한 스토어 관리자에게는 (unlicensed — visible to admins only) 표시와 함께 결제 방식이 계속 보이므로, 키를 구매하기 전에 플러그인을 설정하고 테스트할 수 있습니다. 플러그인 페이지와 WooCommerce 페이지에 알림이 표시됩니다. 기존 주문은 영향을 받지 않으며, 이미 시작된 결제는 계속 확인됩니다.

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

문제 해결

결제 시 Paysera가 나타나지 않음: 라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지, Project ID와 Project password가 모두 입력되었는지 확인하십시오. 둘 중 하나라도 비어 있으면 설정 페이지에 경고가 표시됩니다.

결제는 완료되었지만 주문이 Pending payment 상태에 남아 있음: 주문은 고객이 돌아오는 것이 아니라 Paysera 콜백으로 결제 완료 처리됩니다. 설정에 표시된 콜백 URL에서 사이트가 인터넷에 접근 가능한지 확인하십시오(로그인, 유지 보수 모드 또는 방화벽 뒤에 있지 않아야 합니다). 그리고 WooCommerce > Status > Logs에서 소스 wcp_paysera_payment를 확인하십시오.

콜백이 Invalid signature로 응답함: Project password가 프로젝트와 일치하지 않거나, 콜백이 Paysera에서 온 것이 아닙니다. 프로젝트 비밀번호를 다시 복사하십시오.

콜백이 Project ID mismatch로 응답함: 설정의 Project ID가 결제를 수행한 프로젝트와 다릅니다.

콜백이 Gateway not configured 또는 Busy로 응답함: 프로젝트 ID 또는 비밀번호가 비어 있거나, 같은 주문에 대한 다른 콜백이 아직 실행 중입니다. Paysera가 콜백을 다시 시도합니다.

Paysera가 결제 창을 거부하거나 프로젝트가 없다고 함: Environment를 확인하십시오. 일반 Paysera 프로젝트는 Production에서만 작동합니다. Sandbox에는 Paysera 샌드박스 환경에서 만든 프로젝트가 필요합니다.

테스트 결제가 주문을 결제 완료로 처리하지 않음: TEST 결제는 Test payments가 켜져 있는 동안에만 주문을 결제 완료로 처리합니다. 그렇지 않으면 주문은 요금이 청구되지 않았다는 메모와 함께 보류됩니다. 또한 Paysera 프로젝트에서 Allow test payments도 활성화하십시오.

결제 시 아이콘이 없음: 플러그인은 기본적으로 아이콘을 표시하지 않습니다. 개발자는 wc_psr_gateway_icon 필터로 아이콘을 설정할 수 있습니다.

주문이 금액 또는 통화 불일치 메모와 함께 On hold 상태임: Paysera가 주문 합계와 금액 또는 통화가 일치하지 않는 결제를 확인했습니다. 예를 들어 고객이 결제를 시작한 후 주문이 수정된 경우입니다. Paysera 계정에서 결제를 대조하고 주문을 수동으로 완료하거나 환불하십시오.

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

제거

플러그인을 비활성화하면 모든 데이터가 유지됩니다. 제거하려면 Plugins 페이지에서 비활성화한 후 삭제하십시오. 이 플러그인의 라이선스 키와 라이선스 상태는 항상 제거됩니다. 게이트웨이 설정과 로그는 Delete data가 켜져 있었던 경우에만 제거됩니다. 그렇지 않으면 나중에 다시 설치할 수 있도록 유지됩니다. 기존 주문은 결제 메모와 거래 ID를 유지합니다.

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