VibeFox ePay.bg for OpenCart — 도움말

요구 사항

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

PHP: 8.0 이상.

통화: 불가리아 레프(BGN), 유로(EUR) 또는 미국 달러(USD). 주문은 해당 주문의 통화로 소수점 둘째 자리까지 청구됩니다. 고객이 다른 통화로 체크아웃하면 결제 방법이 숨겨집니다.

ePay.bg 계정: ePay.bg 가맹점 프로필에서 고객 번호(MIN)와 비밀 키가 필요합니다. 운영용은 www.epay.bg에서, 테스트용은 demo.epay.bg에서 확인합니다(테스트 계정은 별도로 등록합니다). 또한 가맹점 프로필에 쇼핑몰의 알림 URL을 입력해야 합니다.

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

설치

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

OpenCart 3

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

2. Extensions > Extensions로 이동하여 유형을 Payments로 선택하십시오. VibeFox ePay.bg Gateway를 찾아 Install(녹색 + 버튼)을 클릭하십시오. 관리자 사용자에게는 결제 확장 기능 목록을 변경할 권한이 있어야 합니다.

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

4. 테스트 및/또는 운영용 MIN과 비밀 키를 입력하십시오(설정 참조).

5. Payment notifications (IPN) 섹션에 표시된 URL을 ePay.bg 가맹점 프로필의 URL for receiving notifications 필드에 복사하십시오. 데모와 운영 프로필 모두에 입력해야 합니다. 이를 입력하지 않으면 어떤 주문도 상태를 받지 못합니다.

6. Enable/Disable을 켜고 Save를 클릭하십시오. 테스트 모드에서 테스트 주문을 한 다음 Test Mode를 끄십시오.

OpenCart 4

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

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

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

4. 라이선스 키, ePay.bg 자격 증명, 알림 URL은 OpenCart 3의 3~6단계와 같이 입력하십시오. 설정 페이지와 필드는 두 버전에서 같습니다. 알림 URL만 다릅니다(결제 알림(IPN) 참조).

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

설정

모든 설정은 확장 기능 페이지에 있습니다: Extensions > Extensions > Payments > VibeFox ePay.bg Gateway > Edit. 섹션은 왼쪽에 나열되며, 목록 아래의 Save 버튼은 페이지 전체를 저장합니다. 설정 위쪽에는 쇼핑몰의 기본 통화가 BGN, EUR, USD 중 하나가 아닐 때 오류가 표시됩니다. 결제 방법은 켜져 있지만 선택한 모드의 MIN 또는 비밀 키가 비어 있으면 경고가 표시됩니다(이 경우 체크아웃에서 숨겨지며, 저장할 때도 같은 경고가 표시됩니다). 테스트 모드가 켜져 있는 동안에는 Test mode is on: payments go to demo.epay.bg and no real money is charged.가 표시됩니다. 확장 기능을 수정할 권한이 없으면 페이지에 설정은 표시되지만 저장할 수 없습니다.

저장할 때 Title은 비워 둘 수 없으며(최대 128자), Sort Order는 정수여야 하고, Total은 0 이상의 숫자여야 합니다. 어느 한 필드라도 잘못되면 아무것도 저장되지 않습니다.

ePay.bg

Enable/Disable: Enable ePay.bg Payment Gateway는 결제 방법을 켜거나 끕니다. 기본값: 꺼짐.

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

Description: Confirm Order 단계에서 고객에게 표시되는 문구입니다. 기본값: Pay securely via ePay.bg with a bank card or your ePay.bg account.

Sort Order: 체크아웃에서 결제 방법 가운데 ePay.bg의 표시 순서입니다. 비워 두거나 정수를 입력하십시오.

Geo Zone: 선택한 지역(Geo Zone)에 있는 결제 주소에만 ePay.bg를 제공합니다. 기본값: All zones. Geo Zone은 System > Localisation > Geo Zones에서 설정합니다.

Total: ePay.bg를 제공하기 전에 주문이 도달해야 하는, 쇼핑몰 기본 통화 기준의 체크아웃 합계입니다. 비워 두면 어떤 합계에서든 ePay.bg를 제공합니다.

ePay.bg 계정

고객 번호(MIN)와 비밀 키는 www.epay.bg(운영)와 demo.epay.bg(테스트 계정, 별도 등록)의 가맹점 프로필에 표시됩니다.

Test Mode: 테스트 모드를 활성화합니다. 고객은 ePay.bg 데모 환경으로 이동하며, 요청은 테스트 자격 증명으로 서명됩니다. 기본값: 켜짐. 켜져 있는 동안 고객은 Confirm Order 단계에서 Test mode (demo.epay.bg): no real payment is taken. 문구를 봅니다.

Test Merchant ID (MIN): demo.epay.bg 가맹점 계정의 고객 번호(MIN)입니다.

Test Secret Key: demo.epay.bg 가맹점 계정의 비밀 키(64자)입니다.

Live Merchant ID (MIN): www.epay.bg 가맹점 계정의 고객 번호(MIN)입니다.

Live Secret Key: www.epay.bg 가맹점 계정의 비밀 키(64자)입니다. HMAC-SHA1 서명에 사용됩니다.

저장된 비밀 키는 다시 표시되지 않습니다. 필드는 비어 있고 Saved — leave empty to keep it.이라고 표시됩니다. 값을 변경하려는 경우에만 새 값을 입력하십시오. 저장된 비밀 키를 삭제하려면 필드 아래의 Clear the saved key on save를 체크한 다음 Save를 클릭하십시오. 붙여넣은 키의 공백과 줄바꿈은 저장할 때 제거됩니다.

결제 알림(IPN)

알림은 결제 요청이 결제되었는지, 거절되었는지, 또는 만료되었는지를 쇼핑몰에 알려 줍니다. Notification URL 필드에는 ePay.bg 가맹점 프로필에서 URL for receiving notifications로 입력해야 하는 URL이 표시되며, 운영과 데모 프로필 모두에 입력해야 합니다. 형식은 OpenCart 3에서 https://your-store/index.php?route=extension/payment/wcp_epaybg_gateway/notify, OpenCart 4에서 https://your-store/index.php?route=extension/wcp_epaybg_gateway/payment/wcp_epaybg_gateway.notify와 같으며, OpenCart 설치의 스토어프런트 주소로 만들어집니다. 설정에 표시된 URL을 정확히 그대로 복사하십시오. 주문은 이 서명된 알림을 통해서만 상태를 받으며, 고객이 쇼핑몰로 돌아왔다고 해서 주문이 결제되는 것은 아닙니다.

ePay.bg는 각 인보이스에 대해 다음 결과를 보고합니다.

유효한 체크섬이 없는 알림은 거부되며, ePay.bg는 계속해서 알림을 보냅니다. 체크섬은 키가 있는 각 모드의 비밀 키로 확인되므로, 테스트와 운영 사이를 전환하기 전에 시작된 결제도 여전히 확인됩니다. 결제는 해당 요청이 이루어진 모드로 도착해야 하며, 그렇지 않으면 주문은 보류(on hold) 상태가 됩니다. 가맹점 프로필에 알림 URL이 없으면 어떤 주문도 상태를 받지 않습니다.

결제 요청

Invoice Prefix: 숫자만 가능(최대 10자리)이며, OpenCart 주문 ID 앞에 붙어 ePay.bg 인보이스 번호를 만듭니다(예: 00001 + 123 = 00001123). 하나의 ePay.bg 계정을 여러 쇼핑몰이 함께 쓸 때는 쇼핑몰마다 다른 접두사를 사용하십시오. 다른 문자는 저장할 때 제거되며, 저장된 접두사를 보여 주는 경고가 표시됩니다. 나중에 접두사를 바꿔도 안전합니다. 미처리 결제 요청은 각 요청에 저장된 인보이스로 찾아집니다. 기본값: 00001.

Expiration Time: 결제되지 않은 결제 요청이 만료되는 시간입니다. 이후 ePay.bg는 이를 만료된 것으로 보고하며, 주문은 상태를 받지 않습니다. 1, 3, 6, 12, 24, 48, 72시간 중에서 선택하십시오. 시간은 쇼핑몰의 시간대와 관계없이 불가리아 시간으로 전송됩니다. 기본값: 24시간.

Language: ePay.bg 결제 페이지의 언어입니다. 영어 또는 불가리아어. 기본값: English.

주문

OpenCart는 Confirm Order 단계에서 주문을 상태 없이(누락된 주문) 생성합니다. 주문은 ePay.bg가 결제를 보고한 뒤에만 상태를 받습니다. 거절되었거나, 만료되었거나, 중단된 결제는 주문을 상태 없이 남기며, 고객은 다시 결제할 수 있습니다. 아래의 상태 필드에는 OpenCart 주문 상태가 나열됩니다.

Order Status After Payment: 결제가 성공한 후 설정되는 상태입니다.

Processing status: Default와 Processing에 해당하는 OpenCart 상태입니다. 기본값: Processing.

Completed status: Completed에 해당하는 OpenCart 상태입니다. 기본값: Complete.

On Hold status: On Hold 및 수동 검토가 필요한 결제에 해당하는 OpenCart 상태입니다. 결제 요청 이후 주문 금액이나 통화가 바뀌었거나, 알림이 다른 모드로 도착했거나, 결제가 도착하기 전에 주문 상태가 변경된 경우(예: 취소)에 사용됩니다. 이런 주문은 결제 완료로 표시되지 않으며, 메모에 이유가 설명됩니다. 기본값: Pending. OpenCart에는 On hold 상태가 없기 때문입니다. System > Localisation > Order Statuses에서 직접 상태를 만들고 여기서 선택할 수 있습니다.

고급

Logging: 결제 요청과 알림을 OpenCart 로그 폴더(storage/logs)의 epay_bp_debug.log.php에 기록합니다. 이 파일은 웹에서 열 수 없으며, 5MB에 도달하면 epay_bp_debug.old.log.php로 옮겨집니다. 비밀 키와 카드 데이터는 기록되지 않습니다. 기본값: 꺼짐. 꺼져 있어도 오류는 항상 기록됩니다.

Log: 로그의 크기와 최신 항목을 보여 줍니다. Clear log를 클릭하면 로그가 비워집니다.

Delete Data on Uninstall: 켜져 있으면 확장 기능을 제거할 때 게이트웨이 설정과 로그가 삭제됩니다. ePay.bg 결제 기록과 주문은 항상 보관됩니다. 기본값: 꺼짐.

가져오기 / 내보내기

Export: Download JSON은 설정을 JSON 파일로 저장합니다. 비밀 키는 내보내지 않습니다.

Import: 이전에 내보낸 JSON을 붙여넣고 Import를 클릭하여 설정을 복원하십시오. 저장된 비밀 키는 유지됩니다.

체크아웃

Payment Method 단계에서 고객은 결제 방법을 선택합니다(기본값은 ePay.bg). Confirm Order 단계에서 고객은 쇼핑몰의 설명과, You will be redirected to ePay.bg to pay with a bank card or your ePay.bg account.라는 안내 문구를 봅니다. OpenCart는 이 단계에서 주문을 생성하며, 여전히 상태는 없습니다. OpenCart 4에서는 고객이 결제 방법 블록의 Choose 버튼을 눌러 Payment method options 창에서 방법을 고르고, 체크아웃 페이지 하단의 Confirm Order를 클릭합니다. 고객이 Confirm Order를 클릭하면, 확장 기능은 주문 통화로 된 주문 합계에 대한 서명된 결제 요청을 인보이스 번호와 만료 시간과 함께 보내며 고객을 ePay.bg로 보냅니다. ePay.bg에서 결제는 Order와 주문 번호로 표시됩니다. ePay.bg에서 고객은 은행 카드나 ePay.bg 계정으로 결제합니다.

결제 후 고객은 쇼핑몰로 돌아옵니다. 주문은 ePay.bg가 서명된 알림으로 결제를 확인한 후에만 결제 완료로 표시됩니다. 그런 다음 주문은 일반적인 OpenCart 방식으로 상태를 받으며, 평소의 주문 이메일이 발송되고 재고가 업데이트됩니다. 알림이 이미 도착했다면 고객은 OpenCart 주문 완료 페이지를 봅니다. 아직 도착하지 않았다면 Payment confirmation 페이지에 Thank you. Your payment is being confirmed by ePay.bg — your order is confirmed as soon as ePay.bg reports the payment.가 표시되고, Check again 및 Back to checkout 버튼이 나타납니다.

고객이 ePay.bg에서 취소하면, The ePay.bg payment was cancelled. You can try again or choose another payment method.라는 메시지와 함께 체크아웃으로 돌아옵니다. ePay.bg가 요청을 거절되었거나 만료된 것으로 보고했다면 메시지는 The payment was not completed. You can try again or choose another payment method.입니다. 장바구니는 유지됩니다. OpenCart 4에서는 이 메시지가 체크아웃 페이지 위에 표시됩니다. 같은 주문에 대한 새 시도는 같은 인보이스 번호를 사용합니다. OpenCart 3은 Confirm Order 단계가 표시될 때마다 새 주문을 생성하고, OpenCart 4는 체크아웃의 주문을 하나 유지하며 업데이트하므로 새 시도는 새 결제 요청으로 같은 주문을 결제합니다. 같은 장바구니의 다른 주문이 이미 결제되었다면 고객은 완료 페이지로 이동하며, 새 결제는 시작되지 않습니다.

OpenCart 4는 성공 페이지가 표시될 때까지 주문을 체크아웃에 유지합니다. 그 사이에 주문이 결제 없이 닫힌 경우(예: 취소한 경우), 고객을 Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order.와 함께 체크아웃으로 돌려보내며, 다음 Confirm Order에서 그 장바구니의 새 주문에 대한 결제가 진행됩니다. 주문이 이미 결제되었지만 그 뒤 장바구니가 변경된 경우(수량 변경 포함), 고객은 체크아웃으로 돌아가며, 다음 Confirm Order에서 새 장바구니가 새 주문으로 결제됩니다. 결제된 주문이 다른 장바구니에 대해 결제 완료로 표시되는 일은 없습니다.

주문을 ePay.bg로 결제할 수 없으면 고객은 Confirm Order 단계에 머무르며 버튼 위에 짧은 메시지를 봅니다. 예를 들어 ePay.bg payments are temporarily unavailable. Please choose another payment method.이거나, ePay.bg가 주문 통화의 결제를 받지 않는다는 내용입니다.

OpenCart 3은 결제 확장 기능의 요청을 통과시키고, OpenCart 4에서는 확장 기능이 알림용 시작 액션(startup action)을 추가하므로, 쇼핑몰이 유지 보수 모드에 있어도 알림은 작동합니다. 이미 시작된 결제의 알림은 결제 방법을 끄더라도 계속 접수됩니다.

이 확장 기능은 ePay.bg에서의 일회성 결제만 받습니다. OpenCart에서의 환불, 저장된 카드, 구독이나 정기 결제, EasyPay 또는 B-Pay 현금 결제 코드는 지원하지 않습니다.

주문

주문 상태

No status (missing order): 고객이 ePay.bg로 보내졌지만 결제하지 않았거나, 알림이 아직 도착하지 않았거나, ePay.bg가 요청을 거절되었거나 만료된 것으로 보고한 경우입니다. Sales > Orders에서 이러한 주문은 Order Status 필터를 Missing Orders로 설정한 경우에만 표시됩니다.

Processing, Completed 또는 On Hold status: 결제가 확인된 상태입니다. 상태는 Order Status After Payment를 따릅니다. 메모에는 인보이스 번호, 결제 날짜, STAN, BORICA 코드가 표시됩니다.

결제 후 On Hold status: 결제는 도착했지만 주문의 현재 내용과 맞지 않습니다. 결제 요청 이후 주문 금액이나 통화가 바뀌었거나, 알림이 요청과 다른 모드(테스트 또는 운영)로 도착했거나, 주문의 결제 방법이 더 이상 ePay.bg가 아닌 경우입니다. 이 결제는 결제 완료로 기록되지 않습니다. 주문에 이미 다른 상태(예: 취소)를 지정했던 경우에도 같은 일이 일어납니다. 메모에 이유가 설명됩니다. ePay.bg 가맹점 패널에서 결제를 확인한 다음, 주문을 수동으로 처리하거나 환불하십시오.

이미 결제된 주문에 대해 결제가 들어오면 상태는 바뀌지 않으며, 메모에서 ePay.bg 가맹점 패널에서 이중 결제가 있는지 확인하라고 안내합니다. 고객이 같은 장바구니의 두 주문을 결제했다면, 두 번째 주문에는 가능한 이중 결제에 대한 메모가 붙습니다. 늦게 도착한 거절이나 만료 알림은 결제 완료된 주문을 절대 바꾸지 않으며, 이미 상태가 있는 주문에는 메모만 추가됩니다.

메모는 고객이 보지 못하는 주문 History의 항목입니다.

VibeFox ePay.bg Gateway 탭

Sales > Orders에서 ePay.bg로 결제된 주문을 여십시오. 주문 페이지 하단, History 및 Additional 옆에 있는 VibeFox ePay.bg Gateway 탭에는 인보이스, 환경(테스트 또는 운영, 테스트 결제에는 Test mode 표시가 붙음), 요청된 금액과 통화, 결제 요청의 상태, 알림 결과, 결제 날짜, STAN, BORICA 코드, 그리고 주문의 ePay.bg notes가 표시됩니다. 이 탭은 읽기 전용이며, 확장 기능에 접근할 수 있는 사용자에게 표시됩니다.

환불

ePay.bg WEB API에는 환불 호출이 없으므로 OpenCart에서의 환불은 제공되지 않습니다. ePay.bg 가맹점 패널에서 결제를 환불한 다음, OpenCart에서 주문 상태를 수동으로 업데이트하십시오. Sales > Returns의 상품 반품은 ePay.bg를 통해 돈을 돌려주지 않습니다.

라이선스 키

이 확장 기능은 vibefox.net에서 받은 VibeFox 라이선스 키로 작동합니다. 라이선스 블록 License — VibeFox ePay.bg Gateway는 Extensions > Extensions > Payments > VibeFox ePay.bg Gateway > Edit 페이지에서 설정 위에 있는 첫 번째 블록입니다. 키를 License key에 붙여넣고 Activate를 클릭하십시오. 이후 블록에는 마스킹된 키, 상태(예: 라이선스가 유효한 날짜와 도메인), 그리고 다음 버튼이 표시됩니다. Check now는 상태를 다시 확인하고, Change key는 다른 키를 입력하며, Remove key는 이 쇼핑몰에서 키를 제거합니다. 그 아래에는 Product: opencart-payment-epaybg 줄과, 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 계정에서 슬롯을 비우십시오.

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

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

문제 해결

ePay.bg가 체크아웃에 나타나지 않음: 라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지, 선택한 모드의 MIN과 비밀 키가 설정되어 있는지, 그리고 고객이 BGN, EUR, USD 중 하나로 체크아웃하는지 확인하십시오. 자격 증명이 없으면 설정 페이지에 경고가 표시됩니다. 또한 결제 주소가 선택한 Geo Zone에 있는지, 그리고 주문이 설정의 Total에 도달하는지 확인하십시오.

결제는 완료되었지만 주문에 상태가 없음: 주문은 ePay.bg 알림을 통해서만 상태를 받습니다. 사용 중인 모드(데모 또는 운영)의 ePay.bg 가맹점 프로필에 알림 URL이 Notification URL에 표시된 그대로 정확히 입력되어 있는지, 그리고 해당 모드의 비밀 키가 맞는지 확인하십시오. 확장 기능 페이지의 Log 필드를 보고, 모든 알림을 보려면 Logging을 켜십시오.

알림이 ERR=Not valid CHECKSUM으로 응답함: 알림을 보낸 가맹점 프로필과 일치하는 저장된 비밀 키가 없습니다. ePay.bg는 계속 재시도하므로, 키가 올바르면 주문은 상태를 받게 됩니다.

알림이 ERR=Not configured로 응답함: 비밀 키가 저장되어 있지 않습니다. 입력하십시오.

알림이 인보이스에 대해 STATUS=NO로 응답함: 해당 인보이스는 이 쇼핑몰에서 발행되지 않았습니다. 예를 들어 같은 ePay.bg 계정을 쓰는 다른 쇼핑몰이 발행한 경우입니다. 쇼핑몰마다 고유한 Invoice Prefix를 지정하십시오.

알림이 STATUS=ERR로 응답함: 일시적인 오류입니다. 예를 들어 같은 순간에 같은 주문에 대한 알림 두 건이 도착했거나, 주문 상태를 설정할 수 없었습니다. ePay.bg는 알림을 다시 보냅니다. 이유는 로그에 있습니다.

알림 URL에 ERR=Method not allowed in the browser가 표시됨: 정상입니다. 이 URL은 ePay.bg의 요청만 받습니다.

고객에게 This payment method is not available. Please reload the checkout page.가 표시됨: 체크아웃 세션이 주문과 더 이상 맞지 않거나, 그사이 결제 방법이 꺼졌습니다. 고객은 체크아웃 페이지를 다시 불러와야 합니다.

고객에게 This order has nothing to pay.가 표시됨: 주문 합계가 0이므로 ePay.bg로 보낼 내용이 없습니다.

결제 후 주문이 On Hold status에 있음: VibeFox ePay.bg Gateway 탭의 메모를 읽고(주문 상태 참조), ePay.bg 가맹점 패널에서 결제를 확인한 다음, 주문을 처리하거나 그곳에서 결제를 환불하십시오.

저장할 때 인보이스 접두사가 변경됨: 접두사에는 숫자만 쓸 수 있으며, 최대 10자리입니다. 다른 문자는 제거됩니다.

개발자용: 결제 양식이 ePay.bg로 전송되기 전에, 확장 기능은 양식 필드와 주문을 포함하여 OpenCart 이벤트 epay_bp_form_fields를 발생시킵니다. 예를 들어 직접 카드 결제 페이지(PAGE=credit_paydirect)를 사용하기 위해서입니다. 이 이벤트로는 서명된 데이터와 체크섬을 변경할 수 없습니다.

제거

Extensions > Extensions로 이동하여 유형을 Payments로 선택하고, VibeFox ePay.bg Gateway 옆의 Uninstall(빨간색 − 버튼)을 클릭하십시오. 이 확장 기능의 라이선스 키와 라이선스 상태는 항상 제거됩니다. OpenCart는 확장 기능 자체의 설정을 항상 제거합니다. 구체적으로 Enable/Disable, Sort Order, Geo Zone, Total과 Orders 섹션의 주문 상태이며, 이들은 다시 설치할 때 기본값으로 돌아갑니다. OpenCart 4에서는 확장 기능의 이벤트와, 유지 보수 모드에서 알림을 통과시키는 시작 액션도 제거됩니다. Delete Data on Uninstall이 켜져 있으면 나머지 게이트웨이 설정(제목, 설명, 테스트 모드, 자격 증명, 결제 요청, 결제 후 주문 상태, 로깅)과 로그도 제거됩니다. 꺼져 있으면 나중에 다시 설치할 수 있도록 보관됩니다. ePay.bg 결제 기록은 항상 보관되므로, 다시 설치하기 전에 시작된 결제도 여전히 확인됩니다. 기존 주문은 결제 메모를 유지합니다.

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

ePay.bg는 각 소유자의 상표입니다. 이 확장 기능은 ePay.bg와 제휴하거나 ePay.bg의 승인을 받지 않았습니다.