VibeFox PayFast for OpenCart — 도움말

요구 사항

OpenCart: 3.0.x (3.0.5.0에서 테스트됨) 또는 4.0.2 이상(4.1.0.3에서 테스트됨).

PHP: 8.0 이상.

Currency: 남아프리카 랜드(ZAR). PayFast는 랜드로만 정산하므로 주문은 ZAR로 이루어져야 합니다. 쇼핑몰에 아직 통화가 없다면 System > Localisation > Currencies에서 추가하십시오. 최소 주문 금액은 R5.00입니다.

PayFast account: PayFast 계정의 Merchant ID와 Merchant Key이며, PayFast 대시보드의 Settings > Developer Settings에서 확인할 수 있습니다. 패스프레이즈 사용을 강력히 권장합니다. PayFast에 패스프레이즈를 설정했다면 같은 패스프레이즈를 확장 프로그램에도 입력해야 합니다. 테스트하려면 PayFast 샌드박스의 인증 정보가 필요합니다.

Reachable store: 결제 알림 URL은 기본 인증이나 방화벽 차단 없이 인터넷에서 접근할 수 있어야 합니다.

VibeFox license key: vibefox.net에서 구매합니다. 키 하나는 도메인 하나에서만 작동합니다.

설치

이 다운로드는 두 OpenCart 버전용 패키지가 들어 있는 zip 파일 하나입니다. 컴퓨터에서 압축을 푸십시오. 압축 파일에는 README.txt, OpenCart 3용 패키지 wcp_payfast_pay-oc3-(version).ocmod.zip, OpenCart 4용 패키지 wcp_payfast_pay.ocmod.zip이 들어 있습니다. 사용하는 OpenCart 버전에 맞는 패키지만 설치하십시오. 라이선스 키는 두 버전 모두 동일합니다.

OpenCart 3

1. 관리자 화면에서 Extensions > Installer로 이동하여 Upload를 클릭하고 wcp_payfast_pay-oc3-(version).ocmod.zip 파일을 선택합니다. 이 확장 프로그램에는 OCMOD 수정 사항이 없으므로 Extensions > Modifications를 새로 고칠 필요가 없습니다. 설치 도구 대신 이 패키지의 upload 폴더 내용을 쇼핑몰의 루트 폴더에 복사할 수도 있습니다.

2. Extensions > Extensions로 이동하여 유형 Payments를 선택합니다. VibeFox PayFast Pay Gateway를 찾아 Install(녹색 + 버튼)을 클릭합니다.

3. Edit(연필 버튼)을 클릭하여 설정 페이지를 엽니다. 페이지 상단의 라이선스 블록에 있는 License key에 VibeFox 라이선스 키를 붙여 넣고 Activate를 클릭합니다(라이선스 키 섹션 참조).

4. Merchant ID, Merchant Key, 패스프레이즈를 입력합니다. 테스트하는 경우 Test mode를 켜 둔 상태로 샌드박스 인증 정보를 입력합니다.

5. Enable/Disable을 켜고 Save를 클릭합니다. 테스트 결제를 한 후 실제 결제를 받으려면 Test mode를 끕니다.

OpenCart 4

1. 관리자 화면에서 Extensions > Installer로 이동하여 Upload를 클릭하고 wcp_payfast_pay.ocmod.zip 파일을 선택합니다. 파일 이름을 바꾸지 마십시오. OpenCart 4는 파일 이름에서 확장 프로그램 코드를 가져오므로, 이름을 바꾼 패키지는 작동하지 않습니다.

2. 설치된 확장 프로그램 목록에 같은 페이지에서 패키지가 나타납니다. 그 옆의 Install(녹색 + 버튼)을 클릭하십시오.

3. Extensions > Extensions로 이동하여 유형 Payments를 선택합니다. VibeFox PayFast Pay Gateway를 찾아 Install(녹색 + 버튼)을 클릭한 뒤 Edit(연필 버튼)를 클릭하십시오.

4. 라이선스 키와 PayFast 인증 정보를 입력하고, OpenCart 3의 3~5단계와 같이 결제를 테스트합니다. 설정 페이지와 그 필드는 두 버전이 같습니다. 다른 점은 알림 URL뿐입니다(Notification URL 참조). 알림 URL도 모든 결제와 함께 PayFast로 전송됩니다.

새로 설치하면 결제 수단은 꺼진 상태이고 테스트 모드는 켜진 상태로 시작합니다.

설정

모든 설정은 확장 프로그램 페이지에 있습니다: Extensions > Extensions > Payments > VibeFox PayFast Pay Gateway > Edit. 섹션은 왼쪽에 나열되며, 목록 아래의 Save 버튼은 페이지 전체를 저장합니다. 설정 위에서는 현재 모드의 인증 정보가 비어 있을 때(이 경우 PayFast는 체크아웃에서 숨겨집니다), 쇼핑몰의 기본 통화가 ZAR이 아닐 때, 실서비스 모드에서 공개 샌드박스 Merchant ID 10000100을 사용할 때, 패스프레이즈가 설정되지 않았을 때 페이지가 경고합니다. 테스트 모드가 켜져 있는 동안에는 Test mode is on: orders are paid in the PayFast sandbox, no real money is charged. 메시지가 표시됩니다.

저장할 때 Title은 비어 있으면 안 되며(최대 128자), Sort Order는 정수여야 합니다(음수 허용). Total은 0 이상의 숫자여야 하고, 선택한 지역 구역과 주문 상태가 존재해야 합니다. 그렇지 않으면 아무것도 저장되지 않으며 페이지에 해당 필드가 표시됩니다. 현재 모드의 인증 정보 없이 결제 수단을 켜면, 경고와 함께 설정이 저장됩니다.

PayFast

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

Title: 체크아웃에서 고객이 보는 결제 수단 이름입니다. 주문에 저장되는 결제 수단 이름이기도 합니다. 기본값: PayFast. 필수.

Description: Confirm Order 단계에서 확인 버튼 위에 고객에게 표시되는 문구입니다. 기본값: Pay securely by card, Instant EFT and other methods on the PayFast payment page.

Sort Order: 체크아웃에서 결제 수단 중 PayFast의 표시 순서입니다. 비워 두거나 정수를 입력하십시오.

Geo Zone: 선택한 지역 구역의 결제 주소에 대해서만 PayFast를 제공합니다. 기본값: All zones. 지역 구역은 System > Localisation > Geo Zones에서 설정합니다. OpenCart 4에서 쇼핑몰이 결제 주소를 요구하지 않으면 배송 주소가 사용됩니다.

Total: PayFast를 제공하기 위해 주문이 도달해야 하는, 쇼핑몰 기본 통화 기준의 체크아웃 금액입니다. 비워 두면 모든 금액에 대해 PayFast를 제공합니다. PayFast 자체는 항상 최소 R5.00을 요구합니다.

PayFast 계정 (실서비스)

Merchant ID와 Merchant Key는 PayFast 대시보드의 Settings > Developer Settings에서 확인할 수 있습니다(해당 섹션으로 가는 링크가 있습니다). 그곳에서 패스프레이즈를 설정했다면 여기에 정확히 같은 값을 입력하십시오.

Merchant ID: 실서비스용 PayFast Merchant ID입니다.

Merchant Key: 실서비스용 PayFast Merchant Key입니다. 모든 결제 양식과 함께 PayFast로 전송되므로 일반 텍스트 필드입니다.

Passphrase: PayFast의 Settings > Developer Settings에 있는 salt 패스프레이즈입니다. 결제와 알림에 서명하므로 강력히 권장합니다.

샌드박스 (테스트 모드)

테스트 모드에서는 결제가 PayFast 샌드박스로 전송되며 실제 금액은 청구되지 않습니다. 샌드박스 인증 정보는 PayFast 샌드박스에 로그인한 후 표시됩니다(공개 테스트 가맹점은 10000100 / 46f0cd694581a입니다).

Test mode: Use the PayFast sandbox and the sandbox credentials below. 켜져 있으면 고객은 Confirm Order 단계에서 TEST MODE: payments go to the PayFast sandbox, no real money is charged. 문구를 봅니다. 기본값: 켜짐.

Sandbox Merchant ID: 샌드박스 계정의 Merchant ID입니다.

Sandbox Merchant Key: 샌드박스 계정의 Merchant Key입니다.

Sandbox Passphrase: 샌드박스 계정에 패스프레이즈가 설정된 경우에만 입력합니다.

저장된 패스프레이즈는 다시 표시되지 않습니다. 필드는 비어 있으며 Saved — leave empty to keep it. 문구가 표시됩니다. 값을 변경하려는 경우에만 새 값을 입력하십시오. 저장된 패스프레이즈를 삭제하려면 필드 아래의 Clear the saved passphrase on save를 체크하고 Save를 클릭합니다.

결제 알림 (ITN)

Notification URL: PayFast는 서버 간 알림을 이곳에 표시된 URL로 보내 모든 결제를 확인합니다. 형태는 OpenCart 3에서 https://your-store/index.php?route=extension/payment/wcp_payfast_pay/itn, OpenCart 4에서 https://your-store/index.php?route=extension/wcp_payfast_pay/payment/wcp_payfast_pay.itn과 같으며, OpenCart 설치의 쇼핑몰 주소로부터 만들어집니다. 이 주소는 모든 결제와 함께 전송되므로 PayFast에서 따로 설정할 필요는 없지만, 인터넷에서 접근할 수 있어야 합니다. 주문은 검증된 이 알림을 통해서만 상태를 얻습니다. 고객이 쇼핑몰로 돌아오는 것만으로는 주문이 바뀌지 않습니다.

Source check: 실서비스 알림은 PayFast 서버에서 온 것만 허용합니다. 주소는 PayFast의 DNS 레코드(6시간 캐시되며, 설정을 저장하면 캐시가 초기화됩니다)와 PayFast가 문서화한 주소 범위에서 가져옵니다. 쇼핑몰이 방문자 주소를 숨기는 프록시나 CDN 뒤에 있는 경우에만 끄십시오. 서명과 서버 확인은 항상 검사합니다. 샌드박스 알림은 주소로 검사하지 않습니다. 기본값: 켜짐.

주문

OpenCart는 Confirm Order 단계에서 주문을 상태 없이(누락된 주문) 만듭니다. 주문은 검증된 PayFast 알림으로부터만 상태를 얻습니다. 취소되었거나 실패했거나 중단된 결제는 주문을 상태 없이 남기며, 고객은 다시 결제할 수 있습니다. 아래의 각 필드는 쇼핑몰의 OpenCart 주문 상태를 나열합니다.

Order Status (paid): PayFast가 결제를 확인하고 금액과 통화가 일치한 후의 상태입니다. 기본값: 처리 중.

Awaiting PayFast payment: PayFast가 결제를 대기 중으로 보고한 경우입니다(예: Instant EFT). PayFast가 결제를 완료하면 결제 완료 상태로 바뀝니다. 기본값: 대기 중.

PayFast payment on hold: 관리자의 검토가 필요한 결제입니다(주문 상태 섹션 참조). 이런 주문은 결제 완료로 표시되지 않으며, 메모에 그 이유가 설명됩니다. 기본값: 대기 중. OpenCart에는 On hold 상태가 없기 때문입니다. System > Localisation > Order Statuses에서 직접 상태를 만들어 여기서 선택할 수 있습니다.

Payment failed: 대기 중이던 결제가 실패했습니다. 나중에 PayFast가 결제를 완료하면 주문은 결제 완료 상태로 바뀝니다. 기본값: 실패.

고급

Debug log: 결제 단계를 OpenCart 로그 폴더(storage/logs)의 payfast_p_debug.log.php에 기록합니다. 이 파일은 웹에서 열 수 없으며, 5 MB에 도달하면 payfast_p_debug.old.log.php로 옮겨집니다. 오류와 경고는 스위치가 꺼져 있어도 항상 기록됩니다. 패스프레이즈, 키, 고객 정보는 기록되지 않습니다. 기본값: 꺼짐.

Log: 로그의 크기와 최신 항목을 표시합니다. Clear log를 클릭하면 비워집니다.

Uninstall: Delete the gateway settings when the extension is uninstalled(설정, 캐시된 PayFast 주소, 로그). PayFast 결제 기록과 주문은 항상 보관됩니다. 기본값: 꺼짐.

가져오기 / 내보내기

Export: Download JSON은 설정을 JSON 파일로 저장합니다. 패스프레이즈는 내보내지 않습니다.

Import: 이전에 내보낸 JSON을 붙여 넣고 Import를 클릭하면 설정이 복원됩니다. 저장된 패스프레이즈는 유지됩니다.

체크아웃

Payment Method 단계에서 고객은 결제 수단을 선택합니다(기본값은 PayFast). Confirm Order 단계에서 고객은 쇼핑몰의 설명과 Thank you for your order. You will be redirected to PayFast to complete the payment. 안내 문구를 봅니다. OpenCart는 이 단계에서 주문을 만들지만 아직 상태는 없습니다. OpenCart 4에서는 고객이 결제 수단 블록의 Choose 버튼을 눌러 Payment method options 창에서 결제 수단을 선택하고, 체크아웃 페이지 하단의 Confirm Order를 클릭합니다. 고객이 Confirm Order를 클릭하면 확장 프로그램이 서명된 결제 양식을 PayFast로 보냅니다. 이 양식에는 ZAR 기준 주문 금액, 주문 번호를 나타내는 Order #, 고객의 이름과 이메일, 결제 참조(주문 번호와 시도 번호), 그리고 해당 시도의 무작위 토큰이 포함됩니다. 새로운 시도마다 새로운 참조와 토큰이 부여됩니다.

PayFast 페이지에서 고객은 카드, Instant EFT 또는 PayFast 계정에서 사용할 수 있는 다른 방법으로 결제합니다. 이후 PayFast가 결제 알림(ITN)을 쇼핑몰로 보냅니다. 주문은 모든 검사를 통과한 알림으로 PayFast가 결제를 확인한 후에만 결제 완료로 표시됩니다.

그 후 주문은 OpenCart의 표준 방식으로 상태를 얻으며, 일반적인 주문 이메일이 발송되고 재고가 업데이트됩니다. 같은 장바구니에 대한 알림은 한 번에 하나씩 처리됩니다. 같은 장바구니의 다른 알림이 처리 중이면 PayFast는 오류 응답을 받고 알림을 다시 보냅니다. 쇼핑몰이 유지 보수 모드에 있어도 알림 URL은 작동합니다. OpenCart 3에서는 OpenCart가 결제 확장 프로그램의 요청을 통과시키고, OpenCart 4에서는 확장 프로그램이 추가하는 시작 액션이 알림과 PayFast에서 고객이 돌아오는 요청을 통과시킵니다.

고객이 돌아왔을 때 주문에 상태가 있으면 OpenCart 주문 완료 페이지가 표시됩니다. PayFast가 결제를 대기 중으로 보고한 경우에는 PayFast is confirming your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. 문구도 표시됩니다. 주문이 보류 중이면 Your payment is being reviewed. We will contact you if anything else is needed. 문구가 표시됩니다. 대기 중이던 결제가 나중에 실패했다면 Your PayFast payment was not completed. Please contact us about this order. 문구가 표시됩니다(OpenCart 4에서는 대신 고객이 체크아웃으로 돌아갑니다. 아래 참조.). 알림이 아직 도착하지 않았다면 Payment confirmation 페이지가 PayFast가 결제를 확인하고 있다고 알리며, Check again과 Back to checkout 버튼이 함께 표시됩니다.

고객이 PayFast 페이지에서 취소하면 The PayFast payment was cancelled. You can try again or choose another payment method. 메시지와 함께 체크아웃으로 돌아옵니다. PayFast가 결제를 실패로 보고했다면 메시지는 The payment was not completed. You can try again or choose another payment method.입니다. 장바구니는 유지되며 다시 결제할 수 있습니다. OpenCart 4에서는 이러한 메시지가 체크아웃 페이지 상단에 표시됩니다. OpenCart 3에서는 Confirm Order 단계가 표시될 때마다 새 주문이 만들어지지만, OpenCart 4는 체크아웃의 주문을 하나 유지하고 업데이트하므로, 취소되었거나 실패한 결제 후 고객은 같은 주문을 새 시도로 결제합니다. 같은 장바구니의 다른 주문이 이미 PayFast에서 처리되었다면(예: 두 번째 브라우저 탭에서), 고객은 다시 결제하는 대신 완료 페이지로 이동합니다.

OpenCart 4는 성공 페이지가 표시될 때까지 주문을 체크아웃에 유지합니다. 그 사이 결제 없이 주문이 닫힌 경우(예: 대기 중이던 결제가 실패했거나 귀하가 주문을 취소한 경우), 고객은 Your previous order was cancelled or its payment failed. Please confirm the order again. 메시지와 함께 체크아웃으로 돌아가며, 다음 Confirm Order에서는 새 주문에 대한 결제가 이루어집니다. 해당 주문에 이미 상태가 있고 장바구니에 다른 상품이나 수량이 있다면, 메시지는 Your previous order has already been placed for other cart contents. Please confirm the order of your current cart again.입니다.

현재 모드의 인증 정보가 없거나, 체크아웃 통화가 ZAR이 아니거나, 합계가 R5.00 미만이면 결제 수단이 숨겨집니다. 그럼에도 고객이 결제 단계에 도달하면 버튼 위에 짧은 메시지가 표시되어 이유를 설명합니다. 예: PayFast accepts payments from R5.00. Please choose another payment method.

이 확장 프로그램은 ZAR로 된 일회성 결제만 받습니다. 주문 페이지에서의 환불, 구독, 저장된(토큰화된) 카드, 분할 결제는 지원하지 않습니다.

주문

주문 상태

No status (missing order): 고객이 PayFast로 이동했으나 결제 알림이 아직 도착하지 않았거나, PayFast가 결제를 실패로 보고했습니다. Sales > Orders에서 이런 주문은 Order Status 필터를 Missing Orders로 설정한 경우에만 표시됩니다.

OpenCart 4에서는 체크아웃의 미결제 주문이 Voided 상태가 될 수 있습니다. 이는 고객이 Confirm Order 단계로 돌아올 때 OpenCart 4가 설정합니다. 확장 프로그램은 이러한 주문을 상태 없는 주문으로 취급하며, 나중에 도착한 결제로 여전히 확인합니다.

Order Status (paid) (default Processing): PayFast가 결제를 확인했습니다. 메모에 PayFast 결제 ID가 표시됩니다. 샌드박스 결제는 실제 금액이 청구되지 않았다는 메모를 받습니다.

Awaiting PayFast payment (default Pending): PayFast가 결제를 대기 중으로 보고했습니다. PayFast가 결제를 완료하면 주문은 결제 완료 상태로 바뀌고, 결제가 실패하면 Payment failed로 바뀝니다. 고객은 이러한 변경 사항을 이메일로 안내받습니다.

Payment failed (default Failed): 대기 중이던 결제가 실패했습니다. 나중에 PayFast가 결제를 완료하면 주문은 결제 완료 상태로 바뀝니다.

PayFast payment on hold (default Pending): 결제된 금액이 주문 합계와 다르거나 주문이 ZAR이 아닌 경우입니다. 또는 그사이 상태를 변경한(예: 취소한) 주문이나 결제 수단이 더 이상 PayFast가 아닌 주문에 대한 결제가 도착한 경우입니다. 또는 게이트웨이가 실서비스 모드인 동안 샌드박스 결제가 도착한 경우입니다. 메모에 그 이유가 설명됩니다. 주문과 PayFast 대시보드를 확인한 다음, 주문을 결제 완료 상태로 설정하거나, 주문을 취소하고 PayFast에서 결제를 환불하십시오.

같은 결제에 대한 반복된 알림은 아무것도 바꾸지 않습니다. 늦게 도착한 실패 또는 대기 중 알림은 결제 완료된 주문을 절대 바꾸지 않습니다. 이미 결제 완료된 주문이나, 이미 결제 완료된 장바구니의 두 번째 주문에 대해 다른 결제 완료 건이 도착하면, 결제 완료된 주문의 메모가 중복 결제를 PayFast에서 환불하라고 안내합니다.

메모는 고객에게 보이지 않는, 주문의 History에 있는 항목입니다.

VibeFox PayFast Pay Gateway 탭

Sales > Orders에서 PayFast로 결제된 주문을 엽니다. 주문 페이지 하단, History와 Additional 옆에 있는 VibeFox PayFast Pay Gateway 탭에는 Payment reference (m_payment_id), PayFast payment ID, Environment(실서비스 또는 샌드박스), 요청 금액, 상태, ZAR 기준 총액·수수료·순액, 그리고 PayFast notes가 표시됩니다. 보류 중인 주문의 경우 결제를 검토하라는 알림이 표시됩니다. 이 탭은 확장 프로그램에 접근 권한이 있는 사용자에게 표시됩니다.

환불

주문 페이지에서의 환불은 지원하지 않습니다. PayFast 대시보드에서 결제를 환불한 후 OpenCart에서 주문을 수동으로 업데이트하십시오.

라이선스 키

이 확장 프로그램은 vibefox.net에서 받은 VibeFox 라이선스 키로 작동합니다. License — VibeFox PayFast Pay Gateway 라이선스 블록은 Extensions > Extensions > Payments > VibeFox PayFast Pay Gateway > Edit에서 설정 위에 있는 첫 번째 블록입니다. License key에 키를 붙여 넣고 Activate를 클릭하십시오. 이후 블록에는 마스킹된 키, 상태(예: 라이선스가 유효한 날짜와 도메인), 그리고 버튼들이 표시됩니다. Check now는 상태를 다시 확인하고, Change key는 다른 키를 입력하며, Remove key는 이 쇼핑몰에서 키를 제거합니다. 그 아래에는 Product: opencart-payment-payfast 줄과, vibefox.net 계정을 여는 Manage licenses and domains in your account 링크가 있습니다. 이 확장 프로그램에 대해 Modify 권한이 있는 관리자 사용자만 키를 변경할 수 있습니다. 블록의 문구는 관리자 화면 언어를 따릅니다(영어와 러시아어가 포함됩니다).

키가 승인되지 않으면 블록에 이유가 표시됩니다. 예: Key not found, This key belongs to another product, Domain limit reached, 또는 날짜와 함께 License expired on. 쇼핑몰 주소를 바꾼 후이거나 계정에서 도메인 슬롯을 비운 후에는 Check now를 클릭하십시오. 라이선스 서버에 연결할 수 없으면 확장 프로그램은 마지막으로 확인된 상태로 계속 작동합니다.

키 하나는 도메인 하나에서만 작동합니다. 이는 OpenCart 설정의 쇼핑몰 주소를 말합니다. 쇼핑몰에서 키를 제거해도 도메인 슬롯은 해제되지 않습니다. vibefox.net 계정에서 슬롯을 해제하십시오.

유효한 키가 없으면 PayFast는 체크아웃에서 고객에게 표시되지 않습니다. 그럼에도 결제가 시작되면 고객은 This payment method is not available. Please choose another one. 메시지를 봅니다. 같은 브라우저에서 관리자 화면에 로그인한 관리자 사용자는 쇼핑몰에서 결제 수단을 (unlicensed — visible to admins only) 표시와 함께 계속 볼 수 있으므로, 키를 구매하기 전에 확장 프로그램을 설정하고 테스트할 수 있습니다. OpenCart 4에서는 이 미리 보기를 사용할 수 없습니다. 쇼핑몰이 관리자 로그인을 인식하지 못하므로, 활성 키가 없으면 결제 수단이 모든 사용자에게 숨겨집니다. Edit 페이지를 한 번 연 후에는 관리자 Dashboard에 알림이 나타납니다. ×로 닫으면 7일 동안 숨겨집니다. 기존 주문에는 영향이 없으며, 이미 시작된 결제는 계속 확인됩니다.

라이선스가 만료되어도 확장 프로그램은 계속 작동하지만, 업데이트와 지원에는 갱신이 필요합니다. 상태는 관리자 Dashboard 또는 Edit 페이지를 열 때 자동으로 다시 확인됩니다. 키를 입력한 후 처음 14일 동안은 하루에 한 번, 그 후에는 일주일에 한 번입니다. cron 작업은 필요하지 않습니다. 확장 프로그램을 제거하면 라이선스 키와 라이선스 상태는 항상 삭제됩니다.

문제 해결

PayFast does not appear at checkout: 라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지, 현재 모드의 Merchant ID와 Merchant Key가 입력되어 있는지, 체크아웃 통화가 ZAR인지, 주문 합계가 최소 R5.00인지 확인하십시오. 무엇이든 빠져 있으면 설정 페이지에 경고가 표시됩니다. 또한 결제 주소가 선택한 Geo Zone에 있는지, 주문이 설정의 Total에 도달했는지도 확인하십시오.

The payment went through, but the order stays without a status: PayFast가 결제 알림을 전달하지 못했거나 알림이 거부되었습니다. 확장 프로그램 페이지의 Log 필드를 확인하십시오. 오류와 거부된 알림은 항상 기록되며, Debug log는 모든 단계를 추가로 기록합니다. 일반적인 원인은 다음과 같습니다. 쇼핑몰이 인터넷에서 접근할 수 없음(기본 인증, 방화벽), PayFast와 확장 프로그램의 패스프레이즈가 다름, 또는 실서비스 모드에서 프록시나 CDN 뒤에 있어 출처 검사에 실패함. 이 경우 Source check를 끄십시오.

The notification answers Invalid signature: 확장 프로그램의 패스프레이즈가, 결제가 이루어진 모드에 대해 PayFast에 설정된 패스프레이즈와 다릅니다.

The notification answers Invalid source: 알림이 PayFast 주소에서 오지 않았거나, 프록시나 CDN이 실제 주소를 숨기고 있습니다. 쇼핑몰이 프록시나 CDN 뒤에 있다면 Source check를 끄십시오.

The notification answers Merchant mismatch or Order mismatch: 결제가 다른 PayFast 계정으로 이루어졌거나 이 결제 시도에 속하지 않습니다. 아무것도 변경되지 않습니다.

The notification answers Order not found: 이 쇼핑몰에는 해당 결제 참조가 없습니다. 아무것도 변경되지 않습니다.

The notification answers Confirmation unavailable, Busy or Temporary error: 서버 확인을 위해 PayFast에 연결할 수 없었거나, 같은 장바구니의 다른 알림이 바로 그 순간 처리되고 있었거나, 주문 상태를 설정할 수 없었습니다. PayFast가 알림을 다시 시도합니다. 로그에 이유가 표시됩니다.

The notification answers Not configured: 결제가 시작된 모드의 인증 정보가 없습니다. 테스트 결제라면 샌드박스 인증 정보처럼 다시 입력하십시오.

The customer sees PayFast accepts payments in South African rand (ZAR) only: 주문이 다른 통화로 되어 있습니다. 고객이 랜드로 결제하게 하거나 다른 결제 수단을 선택하도록 안내하십시오.

The customer sees This payment method is not available. Please reload the checkout page. 체크아웃 세션이 더 이상 주문과 일치하지 않거나, 그 사이에 결제 수단이 꺼졌습니다. 고객은 체크아웃 페이지를 새로 고쳐야 합니다.

Order is in the on-hold status: VibeFox PayFast Pay Gateway 탭의 메모(주문 상태 섹션 참조)와 PayFast 대시보드를 읽은 다음, 결제 완료 상태를 설정하거나 결제를 환불하십시오.

A sandbox payment did not pay the order: 게이트웨이가 실서비스 모드입니다. 실서비스 모드에서는 샌드박스 결제가 주문을 결제 완료로 만들지 않으며, 주문의 메모에 이 내용이 표시됩니다.

개발자용: 결제 양식에 서명하기 전에 확장 프로그램은 양식 필드와 주문을 담아 OpenCart 이벤트 payfast_p_payment_data를 발생시킵니다. 이 이벤트로는 가맹점 인증 정보, URL, 결제 참조, 금액, 토큰을 변경할 수 없습니다.

제거

Extensions > Extensions로 이동하여 유형 Payments를 선택하고, VibeFox PayFast Pay Gateway 옆의 Uninstall(빨간색 − 버튼)을 클릭합니다. 이 확장 프로그램의 라이선스 키와 라이선스 상태는 항상 제거됩니다. OpenCart는 확장 프로그램 자체의 설정을 항상 제거합니다. Enable/Disable, Sort Order, Geo Zone, Total, 그리고 Orders 섹션의 주문 상태가 해당되며, 다시 설치하면 기본값으로 돌아갑니다. 확장 프로그램의 OpenCart 이벤트도 제거됩니다(OpenCart 4에서는 이벤트와 시작 액션도 제거되며, 시작 액션은 유지 보수 모드에서도 알림과 고객의 복귀를 통과시킵니다). Delete the gateway settings when the extension is uninstalled가 켜져 있으면 나머지 게이트웨이 설정(제목, 설명, 인증 정보, 패스프레이즈, 테스트 모드, 출처 검사, 로깅), 캐시된 PayFast 주소, 로그가 삭제됩니다. 꺼져 있으면 나중에 다시 설치할 때를 위해 보관됩니다. PayFast 결제 기록과 주문은 항상 보관됩니다. 기존 주문은 결제 메모를 유지합니다.

OpenCart 4에서 확장 프로그램 파일도 제거하려면, 제거 후 Extensions > Installer로 이동하여 설치된 확장 프로그램 목록에서 VibeFox PayFast Pay Gateway 옆의 Uninstall(주황색 − 버튼)을 클릭한 다음, 업로드된 패키지를 삭제하려면 Delete(빨간색 휴지통 버튼)를 클릭하십시오.

PayFast는 각 소유자의 상표입니다. 이 확장 프로그램은 PayFast와 제휴하거나 PayFast의 승인을 받은 것이 아닙니다.