VibeFox Satispay for WooCommerce — 도움말

요구 사항

WordPress: 6.0 이상.

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

PHP: 8.0 이상, OpenSSL 확장 포함. OpenSSL이 없으면 플러그인은 관리자 영역에 오류를 표시하며 결제 수단이 로드되지 않습니다.

통화: EUR. Satispay는 유로만 청구하므로, 쇼핑몰 통화(주문 결제 페이지에서는 주문 통화)가 EUR가 아니면 결제 수단이 숨겨집니다.

Satispay 계정: Satispay Business 계정. API 키를 복사할 필요는 없습니다. 플러그인은 Satispay Business Dashboard에서 생성하는 일회용 활성화 코드로 연결됩니다(설정 항목 참조). 테스트에는 Satispay 샌드박스 계정이 필요하며, Satispay for developers에서 신청할 수 있습니다.

공개 사이트: 결제 상태가 바뀔 때 Satispay가 사이트를 호출할 수 있도록 쇼핑몰이 인터넷에서 접근 가능해야 합니다. 이를 위해 Satispay에서 별도로 설정할 것은 없습니다.

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

설치

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

2. Activate를 클릭합니다.

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

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

5. 환경을 선택합니다. 테스트에는 Sandbox Mode를 체크하고, 실제 결제에는 체크를 해제합니다.

6. 해당 환경의 활성화 코드를 Activation Code에 붙여 넣고 저장합니다. 연결 상태에 Key ID가 표시됩니다.

7. Enable/Disable을 켜고 저장합니다. 샌드박스에서 결제를 테스트한 뒤, Sandbox Mode 체크를 해제하고 운영 활성화 코드로 운영 환경을 연결합니다.

설정

모든 설정은 한 페이지에 있습니다: WooCommerce > Settings > Payments > Satispay. Satispay connection 섹션에는 두 환경의 상태가 표시되며, 예를 들어 Key ID와 함께 Live: Connected 또는 Sandbox: Not connected로 보이고, 사용 중인 환경도 표시됩니다. 사용 중인 환경이 연결되지 않은 동안에는 페이지에 사용 중인 환경이 연결될 때까지 Satispay는 체크아웃에 표시되지 않습니다.라고 나타납니다. WooCommerce 결제 수단 목록에서는 사용 중인 환경이 연결될 때까지 Satispay에 설정이 필요하다고 표시되며, Sandbox Mode가 켜져 있는 동안에는 테스트 모드 배지가 표시됩니다.

Enable/Disable: Enable Satispay payment는 결제 수단을 켜거나 끕니다. 기본값: 꺼짐.

Checkout

고객이 결제 수단 목록에서 보게 되는 내용입니다.

Title: 체크아웃에 표시되는 결제 수단 이름. 기본값: Satispay.

Description: 체크아웃에서 결제 수단 아래에 표시되는 텍스트. 기본값: Pay with the Satispay app: scan the QR code or confirm the payment on your phone.

Satispay connection

Sandbox Mode: Use the Satispay sandbox (staging) environment. 샌드박스 결제는 청구되지 않습니다. 기본값: 꺼짐. 샌드박스와 운영은 키가 서로 다르므로, 각 환경을 그 환경의 활성화 코드로 연결하십시오. 샌드박스를 사용하는 동안 고객에게는 결제 수단 아래에 샌드박스 모드: 실제 금액은 청구되지 않습니다.라고 표시됩니다.

Activation Code: 위에서 선택한 환경을 연결하려면 새 6자리 활성화 코드를 붙여 넣고 저장합니다. 운영 코드는 Satispay Business Dashboard의 Online shop 섹션에서 생성합니다. 샌드박스 코드는 Satispay 샌드박스 계정과 함께 제공됩니다. 코드는 한 번만 사용되며 저장되지 않습니다. 현재 연결을 유지하려면 이 필드를 비워 두십시오.

코드와 함께 저장하면 플러그인은 RSA 키 쌍을 생성하고, 공개 키와 코드를 Satispay로 보낸 뒤, Key ID와 해당 환경의 키를 WordPress 데이터베이스에 저장합니다. 성공하면 페이지에 예를 들어 Satispay Live connected. Key ID:와 함께 ID가 표시됩니다. Satispay가 코드를 거부하면, 페이지에 Satispay의 메시지가 표시되며 코드가 이 환경용인지, 아직 사용되지 않았는지 확인하라는 안내가 나옵니다. 영문자와 숫자 이외의 문자가 포함된 코드는 아무것도 전송되기 전에 거부됩니다. 환경에 새 코드를 저장하면 기존 연결이 대체됩니다.

Payment notifications

Satispay에서 설정할 것은 없습니다. 모든 결제에는 고유한 콜백 URL이 포함되며, 결제 상태가 바뀌면 Satispay가 이 URL을 호출합니다. 플러그인은 주문을 변경하기 전에 Satispay API에서 결제를 다시 읽습니다. 이 섹션에는 해당 URL의 예시가 표시됩니다. 형식은 다음과 같습니다: https://your-site/wc-api/satispay_payment_callback/?action=callback&order_id={order}&payment_id={uuid}. 이 URL은 인터넷에서 접근 가능해야 합니다. /wc-api/에 점검 모드나 비밀번호 보호가 없어야 합니다.

Advanced

Debug log: Log API calls and payment events는 키나 고객 데이터 없이 WooCommerce > Status > Logs에 기록합니다(소스: wcp_satispay_gateway). 이 옵션이 꺼져 있어도 오류는 항상 기록됩니다. 기본값: 꺼짐.

Delete data on uninstall: Remove the settings and Satispay keys when the plugin is deleted. 주문에 저장된 결제 데이터는 유지됩니다. 기본값: 꺼짐.

체크아웃

고객은 결제 수단(기본값 Satispay)을 선택하고 Pay with Satispay를 클릭합니다. 플러그인은 주문 총액을 유로로 하여 Satispay 결제를 만들고, 참조 번호로 주문 번호를 사용하며, 고객을 Satispay 결제 페이지로 보냅니다. 컴퓨터에서는 고객이 Satispay 앱으로 QR 코드를 스캔합니다. 휴대폰에서는 고객이 앱에서 결제를 확인합니다.

결제 후 고객은 쇼핑몰로 돌아옵니다. 주문은 Satispay가 결제를 확인한 뒤에만 결제 완료로 표시됩니다. 플러그인은 Satispay API에서 결제를 읽고, 해당 주문을 위해 생성된 결제인지 확인한 다음, 상태와 금액(센트 단위), 통화를 주문과 대조합니다. 이 과정은 Satispay가 콜백 URL을 호출할 때와 고객이 돌아올 때 중 먼저 일어나는 쪽에서 실행됩니다. 결제가 아직 확인되지 않았다면 주문 접수 페이지에 Satispay에서 아직 결제를 확인하지 않았습니다. 확인이 도착하면 주문이 자동으로 업데이트됩니다.라고 표시됩니다.

고객이 결제하지 않고 Satispay 페이지를 떠나면, 플러그인은 Satispay에서 결제를 취소하여 버려진 페이지를 더는 결제할 수 없게 합니다. 고객은 체크아웃(또는 주문 결제 페이지)으로 돌아가며 Your Satispay payment was cancelled and nothing was charged. You can try again or choose another payment method. 메시지를 보게 됩니다. 고객이 앱에서 결제를 거부할 때도 같은 메시지가 표시됩니다.

고객은 결제되지 않은 주문을 다시 결제할 수 있습니다. 예를 들어 Pay for order 페이지에서 가능합니다. 새 Satispay 결제를 만들기 전에 이전 결제를 확인합니다. 대기 중인 결제는 Satispay에서 취소되며, 이미 결제가 완료되었다면 주문은 그 결제로 결제 완료 처리되고 두 번째 결제는 만들어지지 않습니다.

결제를 시작할 수 없으면 고객에게 짧은 메시지가 표시되고 다른 결제 수단을 선택할 수 있습니다. 쇼핑몰이 연결되지 않았거나 Satispay가 키를 거부한 경우에는 Satispay is not available at the moment. Please choose another payment method., 그 밖의 오류에는 Unable to create the Satispay payment. Please try again or choose another payment method.가 표시됩니다. 이유는 로그에 기록됩니다.

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

플러그인은 유로로 이루어진 일회성 결제만 받습니다. 구독, 저장된 결제 수단, 사전 승인, 식권은 지원하지 않습니다. 대기 중인 결제를 예약에 따라 확인하는 기능은 없습니다. Satispay 콜백도 고객의 복귀도 쇼핑몰에 도달하지 않으면 주문은 Pending payment 상태로 남고, 결제는 Satispay Dashboard에서 확인할 수 있습니다.

주문 및 환불

Order statuses

Pending payment: 고객이 Satispay로 이동했지만 아직 결제하지 않았거나, Satispay가 아직 결제를 확인하지 않았습니다. 주문 메모에는 Satispay 결제 ID, 금액, 환경(Live 또는 Sandbox)이 표시됩니다.

Processing or Completed: 결제가 확인되었습니다. 주문은 WooCommerce 표준 규칙을 따릅니다. 처리 중(Processing)이 되거나, 가상 다운로드 상품만 있는 주문의 경우 완료(Completed)가 됩니다. 주문 메모에는 Satispay 결제, 금액, 확인 방법(콜백, 리디렉션 또는 체크아웃)이 표시됩니다. 거래 ID는 Satispay 결제 ID입니다.

On hold: Satispay가 주문 총액과 다른 금액이나 통화를 보고했거나, 주문이 취소된 후에 결제가 승인되었습니다. 주문 메모에 이유가 설명되고, 환불할 수 있도록 결제가 거래 ID로 저장됩니다. Satispay Dashboard에서 결제를 확인한 뒤 주문을 완료하거나 결제를 환불하십시오.

Cancelled: 주문의 최신 Satispay 결제가 취소되었거나 만료되었습니다. 예를 들어 고객이 Satispay 페이지를 떠난 경우입니다. 만료된 이전 결제가 진행 중인 최신 결제가 있는 주문을 취소하지는 않습니다. 관리자 영역에서 만든 주문(결제 링크)은 취소되지 않습니다. 이들은 메모와 함께 Pending payment 상태로 남아, 고객이 여전히 결제할 수 있습니다.

이미 결제된 주문에 두 번째 결제가 승인되어도 주문은 변경되지 않습니다. 메모에는 중복 결제를 Satispay Dashboard에서 환불하라는 안내가 표시됩니다. 반복된 확인이 취소되었거나 환불된 주문을 다시 열지는 않습니다.

Refunds

주문을 열고 Refund를 클릭한 다음 금액을 입력하고 Refund via Satispay를 클릭합니다. Satispay로 결제된 주문에 대해 전액 환불과 부분 환불을 지원합니다. 환불은 결제가 이루어진 환경(운영 또는 샌드박스)으로 전송되므로, 해당 환경이 계속 연결되어 있어야 합니다. Satispay가 환불을 승인해야만 환불이 완료된 것으로 간주됩니다. 성공한 환불은 Satispay 환불 ID와 사유와 함께 주문 메모에 추가됩니다. Satispay가 환불을 승인하지 않으면 WooCommerce는 오류를 표시하며 환불은 기록되지 않습니다.

Satispay Dashboard에서 진행한 환불은 WooCommerce 환불로 전환되지 않습니다. 필요하면 Refund via Satispay를 사용하지 말고 WooCommerce에서 수동 환불을 생성하십시오.

라이선스 키

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

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

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

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

문제 해결

Satispay가 체크아웃에 나타나지 않음: 라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지, 사용 중인 환경이 연결되어 있는지(Satispay connection 섹션에 해당 환경이 Connected로 표시되어야 함), 통화가 EUR인지 확인하십시오.

결제는 되었지만 주문이 Pending payment 상태로 남아 있음: Satispay가 사이트를 호출하거나 고객이 돌아올 때 주문이 업데이트됩니다. 사이트가 인터넷에서 접근 가능한지, /wc-api/에 점검 모드나 비밀번호 보호가 없는지 확인하고, WooCommerce > Status > Logs(소스: wcp_satispay_gateway)를 확인하십시오. 결제는 Satispay Dashboard에서 볼 수 있습니다.

콜백이 Payment status unavailable, retry later 또는 Not configured로 응답함: 플러그인이 Satispay에서 결제를 읽을 수 없었거나, 주문의 환경이 연결되어 있지 않습니다. 주문은 변경되지 않습니다. 연결 상태와 로그를 확인하십시오.

콜백이 Busy, retry later로 응답함: 같은 순간에 다른 요청이 주문을 업데이트하고 있었습니다. 이 콜백은 주문을 변경하지 않습니다. 다음 콜백 때나 고객이 돌아왔을 때 업데이트됩니다.

콜백이 Unknown payment 또는 Missing or invalid payment_id로 응답함: 해당 결제가 이 주문을 위해 생성되지 않았거나, 요청이 Satispay 콜백이 아닙니다. 주문은 변경되지 않습니다.

활성화 실패: 활성화 코드는 한 번만 사용할 수 있습니다. 코드가 Sandbox Mode에서 선택한 환경의 코드인지 확인하십시오(운영에는 운영 코드, 샌드박스에는 샌드박스 코드). 새 코드를 생성하고 다시 저장하십시오. 페이지에 RSA 키 쌍을 생성할 수 없다고 표시되면, 호스팅 제공업체에 PHP OpenSSL 확장을 활성화해 달라고 요청하십시오.

샌드박스에서 운영으로 전환한 후 Satispay가 체크아웃에서 사라짐: 샌드박스와 운영은 키가 서로 다릅니다. Sandbox Mode 체크를 해제한 상태에서 운영 활성화 코드를 붙여 넣고 저장하십시오.

주문이 On hold 상태이고 메모가 주문과 맞지 않음: Satispay가 주문 총액과 다른 금액이나 통화를 보고했습니다. 예를 들어 결제가 시작된 뒤 주문이 수정된 경우입니다. Satispay Dashboard에서 결제를 확인한 뒤 주문을 완료하거나 결제를 환불하십시오.

환경이 더 이상 연결되지 않아 환불이 실패함: 결제는 운영 또는 샌드박스에서 이루어졌지만, 해당 환경에는 이제 키가 없습니다. 활성화 코드로 다시 연결하거나, Satispay Dashboard에서 결제를 환불하십시오.

Satispay did not accept the refund 메시지와 함께 환불이 실패함: Satispay가 accepted가 아닌 상태를 반환했습니다. WooCommerce는 환불을 기록하지 않았습니다. Satispay Dashboard에서 확인하십시오.

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

삭제

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

Satispay는 해당 소유자의 상표입니다. 이 플러그인은 Satispay와 제휴하거나 Satispay의 승인을 받지 않았습니다.