VibeFox iPay88 for WooCommerce — 도움말

요구 사항

WordPress: 6.0 이상.

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

PHP: 8.0 이상.

iPay88 가맹점 계정: Merchant Code와 Merchant Key는 가맹점 계정이 활성화될 때 iPay88에서 발급합니다. iPay88 가맹점 포털에서도 확인할 수 있습니다. 아직 가맹점이 아니라면 iPay88 웹사이트에서 신청하십시오. Merchant Key는 비밀로 유지하십시오. 결제에 서명하는 데 사용됩니다.

Request URL: 쇼핑몰 주소가 iPay88에 Request URL로 등록되어 있어야 합니다. 그렇지 않으면 iPay88 페이지에 "Permission not allow"가 표시됩니다.

쇼핑몰 통화: Malaysia — MYR이며, iPay88 계정에서 다중 통화 옵션을 켠 경우 USD, SGD, AUD, CAD, EUR, GBP, HKD, CNY, TWD, INR, IDR, PHP, THB도 가능합니다. Philippines — PHP 또는 USD. Indonesia — IDR. Thailand — THB.

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

설치

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

2. Activate를 클릭합니다.

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

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

5. iPay88 region을 선택하고 Merchant Code와 Merchant Key를 입력합니다(구성 항목 참조).

6. Enable/Disable을 켭니다. 설정을 확인하려면 Test mode를 켠 상태로 결제한 뒤 테스트 모드를 끕니다.

구성

모든 설정은 한 페이지에 있습니다: WooCommerce > Settings > Payments > iPay88. 입력란 위에서 페이지는 다음 경우에 경고를 표시합니다. Merchant Code 또는 Merchant Key가 없을 때(이 경우 결제 방법이 체크아웃에 표시되지 않습니다), 쇼핑몰 통화를 선택한 지역에서 청구할 수 없을 때, 그리고 테스트 모드가 켜져 있는 동안입니다. 결제 방법 목록에서 iPay88은 두 키가 모두 입력될 때까지 설정이 필요하다고 표시되며, 테스트 모드가 켜져 있는 동안에는 테스트 모드 배지를 표시합니다.

일반

Enable/Disable: Enable iPay88 Payment Gateway는 결제 방법을 켜거나 끕니다. 기본값: 끔.

Title: 고객이 체크아웃에서 보는 결제 방법 이름입니다. 기본값: iPay88.

Description: 체크아웃에서 결제 방법 아래에 표시되는 텍스트입니다. 기본값: Pay securely via iPay88 (credit card, online banking, e-wallet).

iPay88 계정

iPay88 region: iPay88 가맹점 계정의 국가입니다. iPay88 결제 페이지와 청구할 수 있는 통화를 결정합니다. 주문은 항상 해당 통화로 청구됩니다. 기본값: Malaysia.

Malaysia (payment.ipay88.com.my): MYR, 그리고 계정에서 다중 통화가 켜진 경우 요구 사항에 나열된 다른 통화.

Philippines (payment.ipay88.com.ph): PHP, USD.

Indonesia (payment.ipay88.co.id): IDR, 소수점 없이 전송됩니다.

Thailand (payment.ipay88.co.th): THB.

Merchant Code: iPay88 Merchant Code입니다. 예: M01234.

Merchant Key: iPay88 Merchant Key입니다. 결제 요청에 서명하고 iPay88 응답을 검증합니다. 비밀로 유지하십시오.

Signature type: 결제 요청에 서명하는 방식입니다. 응답은 두 형식 모두로 검증합니다.

SHA256 (recommended): 현재 iPay88 사양(기본값)입니다.

SHA1 (legacy): iPay88이 기존 서명을 사용하도록 요청한 경우에만 선택하십시오.

결제

Payment method: 말레이시아 PaymentId 목록에서 iPay88 결제 방법 하나를 미리 선택하거나, Let the customer choose on the iPay88 page(기본값)를 그대로 두십시오. 목록에는 Credit Card (MYR), FPX (Online Banking), Maybank2U, Alliance Online, AmBank, RHB Bank, Hong Leong Bank, CIMB Clicks, Web Cash, PayPal (MYR), Credit Card (PHP), Boost, Touch n Go eWallet, GrabPay, ShopeePay가 포함됩니다.

Reference prefix: 선택 사항입니다. iPay88 참조 번호(RefNo)에서 주문 번호 앞에 추가됩니다. 예: SHOP1-. 같은 iPay88 계정을 사용하는 쇼핑몰마다 다른 접두사를 설정하십시오. 그래야 한 쇼핑몰의 응답이 다른 쇼핑몰의 주문에 적용될 수 없습니다. 영문자, 숫자, "-", "_"를 사용할 수 있으며 최대 10자입니다. 숫자로 끝나는 접두사는 주문 번호가 참조 번호의 끝에서 읽히기 때문에 저장할 때 수정됩니다.

Test mode: Charge a fixed test amount instead of the order total. iPay88에는 별도의 샌드박스가 없습니다. 테스트 결제는 실제 iPay88 결제 페이지에서 소액(1.00; IDR 10,000)으로 이루어지는 실제 거래입니다. 테스트 금액이 수신되면 주문은 결제 완료로 표시되고 주문 메모에 그 내용이 기록됩니다. 테스트 모드가 켜져 있는 동안 체크아웃에는 TEST MODE: only a test amount of ... will be charged.가 표시됩니다. 실제 운영 쇼핑몰에서는 테스트 모드를 절대 켜 두지 마십시오. 기본값: 끔.

응답 및 백엔드 URL

플러그인은 모든 결제에서 두 URL을 함께 전송하므로 따로 구성할 것이 없습니다. iPay88이 요청하면 설정의 이 섹션에서 복사하십시오. 형식은 다음과 같습니다: https://your-site/wc-api/ipay88_p_response/(Response URL, 고객의 복귀)과 https://your-site/wc-api/ipay88_p_backend/(Backend URL, 서버 간 알림). 이 섹션에는 iPay88에 Request URL로 등록되어야 하는 쇼핑몰 주소도 표시됩니다.

iPay88의 두 응답은 같은 방식으로 확인됩니다. Merchant Key로 생성된 서명, 이 쇼핑몰이 해당 주문에 대해 시작한 결제의 참조, 금액과 통화입니다. 유효한 서명이 없는 요청은 거부되며 주문을 변경하지 않습니다. 백엔드 알림은 처리가 완료된 후에만 RECEIVEOK로 응답합니다. 그렇지 않으면 iPay88이 다시 전송합니다. iPay88은 다음 결제 상태를 보고합니다:

1 (성공): 결제가 완료되었습니다. 금액과 통화를 확인한 후 주문이 결제 완료로 표시됩니다.

6 (대기): ATM 또는 가상계좌 이체처럼 결제가 아직 대기 중입니다. iPay88이 확인하거나 실패로 처리할 때까지 주문은 보류 상태가 됩니다.

그 밖의 상태: 결제가 실패했거나 취소되었습니다. 주문은 iPay88이 제공한 사유와 함께 실패 상태가 됩니다.

고급

Debug log: WooCommerce > Status > Logs에서 소스 wcp_ipay88_payment의 Log payment requests and iPay88 responses입니다. 개인정보나 서명은 기록되지 않습니다. 오류는 항상 기록됩니다. 기본값: 끔.

Delete data on uninstall: Delete the settings, logs and iPay88 order data when the plugin is deleted. 주문 자체는 절대 삭제되지 않습니다. 기본값: 끔.

체크아웃

고객은 결제 방법(기본값 iPay88)을 선택하고 주문합니다. 주문은 Pending payment 상태로 남고, 쇼핑몰이 속한 지역의 iPay88 결제 페이지로 양식이 전송되는 동안 고객에게는 Redirecting to iPay88 payment gateway...가 표시됩니다. JavaScript가 없으면 고객은 Pay Now를 클릭합니다. 주문 상품과 고객의 이름, 이메일, 전화번호가 iPay88에 전달됩니다. iPay88 페이지에서 고객은 카드, FPX 온라인 뱅킹, 전자지갑 또는 계정에서 제공하는 다른 방법으로 결제합니다.

결제 후 고객은 쇼핑몰의 주문 접수 페이지로 돌아갑니다. 주문은 고객의 복귀 시 또는 백엔드 알림을 통해 iPay88이 서명된 응답으로 결제를 확인한 후에만 결제 완료로 표시됩니다. 확인이 아직 도착하지 않았다면 페이지에 We have not received the payment confirmation from iPay88 yet. If you completed the payment, your order will be updated shortly.가 표시됩니다. 대기 중인 결제라면 Your payment is pending confirmation from iPay88. We will update your order as soon as the payment is confirmed.가 표시됩니다.

결제가 실패했거나 취소된 경우 고객은 The payment was not completed:와 iPay88의 사유가 표시된 Pay for order 페이지로 이동하며, 다시 결제하거나 다른 결제 방법을 선택할 수 있습니다. 응답을 검증할 수 없으면 고객에게 The payment response could not be verified. If you completed the payment, please contact us with your order number — the payment will be checked manually.와 쇼핑몰로 돌아가는 링크가 표시됩니다.

재고는 고객이 리디렉션될 때가 아니라 결제가 확인될 때 차감됩니다. 이 결제 방법은 클래식 체크아웃, 체크아웃 블록, Pay for order 페이지에서 작동합니다. WooCommerce 고성능 주문 저장소(HPOS)와 호환됩니다.

플러그인은 일회성 결제만 지원합니다. WooCommerce에서의 환불, 카드 저장, 구독, 사전 승인 및 캡처, 쇼핑몰의 카드 입력 필드는 지원하지 않습니다. 결제 상태를 iPay88에 다시 조회하지 않습니다. 주문은 iPay88 응답과 백엔드 알림으로만 업데이트됩니다. iPay88 Indonesia API 2.0(JSON / 결제 링크)은 사용하지 않습니다.

주문

Order statuses

Pending payment: 고객이 iPay88로 이동했지만 아직 결제하지 않았거나, iPay88이 아직 결제를 확인하지 않은 상태입니다.

Processing or Completed: 결제가 확인되었습니다. WooCommerce가 결제 완료 주문에 맞는 일반 상태를 설정합니다. 주문 메모에는 iPay88 TransID, PaymentID, 금액, 통화가 표시됩니다. 거래 ID는 iPay88 TransID입니다. 테스트 모드에서는 두 번째 메모에 주문 합계 대신 테스트 금액이 청구되었다고 기록됩니다.

On hold, pending at iPay88: iPay88이 결제를 대기 중으로 보고했습니다. iPay88이 결제를 확인하거나 실패로 처리하면 주문이 업데이트됩니다.

On hold, for review: iPay88이 주문과 다른 금액이나 통화로 성공한 결제를 보고했거나, 주문이 취소된 후에 결제가 도착했습니다. 주문은 결제 완료로 표시되지 않았습니다. 주문 메모에 이유가 설명되어 있습니다. iPay88 포털에서 결제를 확인한 다음 주문을 처리하거나 결제를 환불하십시오.

Failed: 결제가 실패했거나 취소되었습니다. 메모에 iPay88의 사유가 표시됩니다. 고객은 다시 결제할 수 있습니다.

이미 결제 완료되었거나 환불된 주문에 다른 성공 결제가 도착하면 주문은 변경되지 않습니다. 메모는 iPay88 포털에서 확인하고 중복 결제라면 환불하라고 요청합니다. 실패 응답은 결제 완료, 환불, 취소된 주문을 절대 변경하지 않습니다.

환불

환불은 WooCommerce에서 iPay88으로 전송되지 않습니다. iPay88 가맹점 포털에서 결제를 환불하고, WooCommerce에는 환불을 수동으로 기록하십시오.

라이선스 키

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

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

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

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

문제 해결

체크아웃에 iPay88이 나타나지 않음: 라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지, Merchant Code와 Merchant Key가 입력되었는지, 쇼핑몰 통화를 선택한 iPay88 region에서 청구할 수 있는지 확인하십시오. 누락된 항목이 있으면 설정 페이지에 경고가 표시됩니다.

결제는 완료되었지만 주문이 Pending payment 상태로 남아 있음: 고객의 복귀도, 백엔드 알림도 유효한 서명과 함께 쇼핑몰에 도착하지 않았습니다. Debug log를 켜고 WooCommerce > Status > Logs에서 소스 wcp_ipay88_payment를 확인하십시오. Merchant Key가 iPay88에서 제공한 키와 정확히 일치하는지, 그리고 쇼핑몰이 설정에 표시된 Backend URL에서 iPay88의 요청을 받을 수 있는지 확인하십시오.

iPay88 페이지에 "Permission not allow"가 표시됨: 쇼핑몰 주소가 iPay88에 Request URL로 등록되어 있지 않습니다. iPay88에 Response and backend URLs 섹션에 표시된 주소를 등록해 달라고 요청하십시오.

백엔드 알림이 BAD SIGNATURE로 응답함: 서명이 Merchant Key와 일치하지 않습니다. Merchant Key를 확인하십시오.

백엔드 알림이 NOT CONFIGURED로 응답함: Merchant Code 또는 Merchant Key가 설정되지 않아 응답을 검증할 수 없습니다. iPay88이 알림을 다시 전송합니다.

백엔드 알림이 UNKNOWN ORDER로 응답함: 이 쇼핑몰에서 이 참조에 대해 iPay88 결제가 시작되지 않았습니다. 예를 들어 같은 계정을 쓰는 다른 쇼핑몰이 Reference prefix를 사용하지 않거나 같은 접두사를 사용하고 있을 수 있습니다.

주문이 On hold 상태이며 금액 또는 통화에 관한 메모가 있음: iPay88이 주문과 일치하지 않는 결제를 보고했거나, 주문이 취소되었습니다. 주문은 결제 완료로 표시되지 않았습니다. iPay88 포털에서 결제를 확인하고 완료하거나 환불하십시오.

고객에게 "iPay88 cannot accept payments in"과 통화가 표시됨: 주문 통화를 선택한 지역에서 청구할 수 없습니다. iPay88 Malaysia에서는 MYR 이외의 통화에 iPay88 계정의 다중 통화 옵션도 필요합니다.

실제 고객에게 1.00만 청구됨: Test mode가 켜져 있습니다. 끄십시오.

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

개발자는 ipay88_p_payment_url, ipay88_p_supported_currencies, ipay88_p_currency_decimals, ipay88_p_test_amount, ipay88_p_icon 필터로 결제 페이지 URL, 통화, 소수점 자릿수, 테스트 금액, 아이콘을 변경할 수 있습니다.

제거

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

iPay88은 각 소유자의 상표입니다. 이 플러그인은 iPay88과 제휴하지 않으며 iPay88의 승인을 받지 않았습니다.