HeuJung
f9c4c025cb
공개 이슈(gnuboard/g7) 17건 전수 대조에서 "진짜 누락"으로 판정된 5건을 해소한다.
— 서버가 만들어 내보내는 상점 주소가 각 지점에서 `/shop` 리터럴이나
`"/{$routePath}/..."` 조립으로 흩어져 있었다. 기본값이 아닌 상점에서는 그 주소가
존재하지 않는 화면을 가리키는데, 서버는 문자열을 만들어 내려보냈을 뿐이라 예외도
404 로그도 남지 않는다 — 링크만 조용히 죽는다. `ShopPathResolver` 를 단일 해석
지점으로 두고 주문 완료 이동·비회원 조회 안내·알림 메일·통합검색·상품문의·SEO
캐시·사이트맵 전 지점을 경유시켰다. 같은 값에 종속된 PG 4종 리다이렉트는
`{shopBase}` 자리표시자로, 편집기 상태 scope 는 선택 세그먼트 토큰 `/*?`
(engine-v1.58.0)로 해소했다. 기설치본은 업그레이드 스텝이 백필한다.
M-02 — 답변 깊이 상한이 config 는 1~10 인데 컬럼 comment 만 1~5 로 남아,
comment 에서 자동 생성되는 계약 문서 4곳이 실제보다 좁은 상한을 공개하고 있었다.
L-01 — 관리자 게시글 폼에 첨부 안내가 아예 없었고, 대신 사장된 고정 문구
("최대 5개 파일, 각 10MB")가 남아 있었다. 게시판마다 다른 실제 설정값을 렌더한다.
— 목록 1페이지가 공지 전량을 상한 없이 읽던 것에 안전상한을 두고(구조 무변경,
limit 부가만), 조회수 정렬 목록 술어를 덮는 복합 색인을 신설했다.
브라우저 실측 검수에서 발견한 사전 결함 1건(사용자 게시판 목록이 URL 정렬
파라미터를 데이터소스로 전달하지 않던 문제)도 함께 고쳤다. 폴백을 빈 문자열로 둬
URL 에 정렬이 없을 때 게시판 설정을 덮어쓰지 않게 했다.
431 lines
19 KiB
PHP
431 lines
19 KiB
PHP
<?php
|
|
|
|
namespace Plugins\Sirsoft\PayKginicis;
|
|
|
|
use App\Extension\AbstractPlugin;
|
|
|
|
class Plugin extends AbstractPlugin
|
|
{
|
|
public function getMetadata(): array
|
|
{
|
|
return [
|
|
'author' => 'Sirsoft',
|
|
'license' => 'MIT',
|
|
'homepage' => 'https://sir.kr',
|
|
'keywords' => ['payment', 'kginicis', 'inicis', 'pg', 'card', 'ecommerce', 'japan'],
|
|
];
|
|
}
|
|
|
|
public function getSettingsSchema(): array
|
|
{
|
|
return [
|
|
'is_test_mode' => [
|
|
'type' => 'boolean',
|
|
'default' => true,
|
|
'label' => ['ko' => '테스트 모드', 'en' => 'Test Mode'],
|
|
'hint' => [
|
|
'ko' => '테스트 모드에서는 실제 결제가 발생하지 않습니다.',
|
|
'en' => 'No real payments occur in test mode.',
|
|
],
|
|
],
|
|
'test_mid' => [
|
|
'type' => 'string',
|
|
'default' => 'INIpayTest',
|
|
'label' => ['ko' => '테스트 가맹점 ID (MID)', 'en' => 'Test Merchant ID (MID)'],
|
|
'hint' => [
|
|
'ko' => 'KG 이니시스에서 발급받은 테스트 MID',
|
|
'en' => 'Test MID issued by KG Inicis',
|
|
],
|
|
],
|
|
'test_sign_key' => [
|
|
'type' => 'string',
|
|
'default' => 'SU5JTElURV9UUklQTEVERVNfS0VZU1RS',
|
|
'sensitive' => true,
|
|
'label' => ['ko' => '테스트 사인키', 'en' => 'Test Sign Key'],
|
|
'hint' => [
|
|
'ko' => '결제창 서명 생성에 사용되는 키입니다.',
|
|
'en' => 'Key used for payment window signature generation.',
|
|
],
|
|
],
|
|
'test_iniapi_key' => [
|
|
'type' => 'string',
|
|
'default' => 'ItEQKi3rY7uvDS8l',
|
|
'sensitive' => true,
|
|
'label' => ['ko' => '테스트 INIAPI 키', 'en' => 'Test INIAPI Key'],
|
|
'hint' => [
|
|
'ko' => '취소 API 인증에 사용되는 키입니다.',
|
|
'en' => 'Key used for cancel API authentication.',
|
|
],
|
|
],
|
|
'test_iniapi_iv' => [
|
|
'type' => 'string',
|
|
'default' => 'HYb3yQ4f65QL89==',
|
|
'sensitive' => true,
|
|
'label' => ['ko' => '테스트 INIAPI IV', 'en' => 'Test INIAPI IV'],
|
|
'hint' => [
|
|
'ko' => '취소 API 암호화에 사용되는 초기화 벡터입니다.',
|
|
'en' => 'Initialization vector for cancel API encryption.',
|
|
],
|
|
],
|
|
'live_mid' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'label' => ['ko' => '라이브 가맹점 ID (MID)', 'en' => 'Live Merchant ID (MID)'],
|
|
],
|
|
'live_sign_key' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'sensitive' => true,
|
|
'label' => ['ko' => '라이브 사인키', 'en' => 'Live Sign Key'],
|
|
'hint' => [
|
|
'ko' => '외부에 노출되지 않도록 주의하세요.',
|
|
'en' => 'Keep this key secret.',
|
|
],
|
|
],
|
|
'live_iniapi_key' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'sensitive' => true,
|
|
'label' => ['ko' => '라이브 INIAPI 키', 'en' => 'Live INIAPI Key'],
|
|
'hint' => [
|
|
'ko' => '외부에 노출되지 않도록 주의하세요.',
|
|
'en' => 'Keep this key secret.',
|
|
],
|
|
],
|
|
'live_iniapi_iv' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'sensitive' => true,
|
|
'label' => ['ko' => '라이브 INIAPI IV', 'en' => 'Live INIAPI IV'],
|
|
],
|
|
'test_mobile_hash_key' => [
|
|
'type' => 'string',
|
|
'default' => '3CB8183A4BE283555ACC8363C0360223',
|
|
'sensitive' => true,
|
|
'label' => ['ko' => '테스트 모바일 해시키', 'en' => 'Test Mobile Hash Key'],
|
|
],
|
|
'live_mobile_hash_key' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'sensitive' => true,
|
|
'label' => ['ko' => '라이브 모바일 해시키', 'en' => 'Live Mobile Hash Key'],
|
|
],
|
|
'use_escrow' => [
|
|
'type' => 'boolean',
|
|
'default' => false,
|
|
'label' => ['ko' => '에스크로 결제 활성화', 'en' => 'Enable Escrow Payment'],
|
|
'hint' => [
|
|
'ko' => '활성화 시 PC는 acceptmethod 에 useescrow 가 추가되고, 모바일은 P_RESERVED 에 useescrow=Y 가 추가됩니다.',
|
|
'en' => 'When enabled, acceptmethod adds useescrow on PC and P_RESERVED adds useescrow=Y on mobile.',
|
|
],
|
|
],
|
|
'japan_enabled' => [
|
|
'type' => 'boolean',
|
|
'default' => false,
|
|
'label' => ['ko' => '일본 결제 활성화', 'en' => 'Enable Japan Payment'],
|
|
'hint' => [
|
|
'ko' => '일본 엔(JPY) 결제를 위한 별도 MID가 필요합니다.',
|
|
'en' => 'Requires a separate MID for Japanese Yen (JPY) payments.',
|
|
],
|
|
],
|
|
'japan_restrict_jpy_payment_methods' => [
|
|
'type' => 'boolean',
|
|
'default' => false,
|
|
'label' => ['ko' => 'JPY 주문 결제수단 제한', 'en' => 'Restrict JPY Payment Methods'],
|
|
'hint' => [
|
|
'ko' => '활성화하면 JPY 주문은 신용카드, PayPay, 일본 편의점결제만 CBT로 진행됩니다.',
|
|
'en' => 'When enabled, JPY orders can proceed through CBT only with credit card, PayPay, or Japan convenience store payment.',
|
|
],
|
|
],
|
|
'test_japan_sign_key' => [
|
|
'type' => 'string',
|
|
'default' => '5AL5Djb1Ipualn0F',
|
|
'sensitive' => true,
|
|
'label' => ['ko' => '테스트 일본 CBT 해시키', 'en' => 'Test Japan CBT Hash Key'],
|
|
'hint' => [
|
|
'ko' => 'CBT 해시 데이터 생성에 사용되는 테스트 KEY입니다.',
|
|
'en' => 'Test KEY used for CBT hash data generation.',
|
|
],
|
|
],
|
|
'live_japan_mid' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'label' => ['ko' => '라이브 일본 MID', 'en' => 'Live Japan MID'],
|
|
],
|
|
'live_japan_sign_key' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'sensitive' => true,
|
|
'label' => ['ko' => '라이브 일본 CBT 해시키', 'en' => 'Live Japan CBT Hash Key'],
|
|
'hint' => [
|
|
'ko' => 'CBT 해시 데이터 생성에 사용되는 라이브 KEY입니다. 외부에 노출되지 않도록 주의하세요.',
|
|
'en' => 'Live KEY used for CBT hash data generation. Keep this key secret.',
|
|
],
|
|
],
|
|
'japan_merchant_name' => [
|
|
'type' => 'string',
|
|
'default' => 'サンプルストア',
|
|
'label' => ['ko' => '일본 결제 가맹점명', 'en' => 'Japan Payment Merchant Name'],
|
|
],
|
|
'japan_merchant_name_kana' => [
|
|
'type' => 'string',
|
|
'default' => 'サンプルストア',
|
|
'label' => ['ko' => '일본 결제 가맹점명 Kana', 'en' => 'Japan Payment Merchant Name Kana'],
|
|
],
|
|
'japan_merchant_name_alphabet' => [
|
|
'type' => 'string',
|
|
'default' => 'Sample Store',
|
|
'label' => ['ko' => '일본 결제 가맹점명 영문', 'en' => 'Japan Payment Merchant Name Alphabet'],
|
|
],
|
|
'japan_merchant_name_short' => [
|
|
'type' => 'string',
|
|
'default' => 'サンプル',
|
|
'label' => ['ko' => '일본 결제 가맹점 약칭', 'en' => 'Japan Payment Merchant Short Name'],
|
|
],
|
|
'japan_contact_name' => [
|
|
'type' => 'string',
|
|
'default' => 'サポート窓口',
|
|
'label' => ['ko' => '일본 결제 문의처명', 'en' => 'Japan Payment Contact Name'],
|
|
],
|
|
'japan_contact_email' => [
|
|
'type' => 'string',
|
|
'default' => 'support@example.com',
|
|
'label' => ['ko' => '일본 결제 문의 이메일', 'en' => 'Japan Payment Contact Email'],
|
|
],
|
|
'japan_contact_phone' => [
|
|
'type' => 'string',
|
|
'default' => '0120-123-456',
|
|
'label' => ['ko' => '일본 결제 문의 전화번호', 'en' => 'Japan Payment Contact Phone'],
|
|
],
|
|
'japan_contact_opening_hours' => [
|
|
'type' => 'string',
|
|
'default' => '10:00-18:00',
|
|
'label' => ['ko' => '일본 결제 문의 영업시간', 'en' => 'Japan Payment Contact Hours'],
|
|
],
|
|
'redirect_success_url' => [
|
|
'type' => 'string',
|
|
'default' => '{shopBase}/orders/{orderId}/complete',
|
|
'label' => ['ko' => '결제 성공 리다이렉트 URL', 'en' => 'Payment Success Redirect URL'],
|
|
'hint' => [
|
|
'ko' => '{shopBase}는 상점 주소 설정을 따라 자동으로 채워집니다. 전체 URL(https://...)을 직접 넣어도 됩니다. {orderId}는 주문번호로 자동 치환됩니다.',
|
|
'en' => '{shopBase} is filled in from the storefront address setting. You may also enter a full URL (https://...). {orderId} will be replaced with the actual order number.',
|
|
],
|
|
],
|
|
'redirect_fail_url' => [
|
|
'type' => 'string',
|
|
'default' => '{shopBase}/checkout',
|
|
'label' => ['ko' => '결제 실패 리다이렉트 URL', 'en' => 'Payment Failure Redirect URL'],
|
|
'hint' => [
|
|
'ko' => '상대 경로 또는 전체 URL 모두 가능합니다. 오류 정보는 쿼리 파라미터로 자동 추가됩니다.',
|
|
'en' => 'Supports relative paths or full URLs. Error details are appended as query parameters.',
|
|
],
|
|
],
|
|
'easy_pay_allow_with_other_pg' => [
|
|
'type' => 'boolean',
|
|
'default' => false,
|
|
'label' => ['ko' => '타 PG와 사용가능함', 'en' => 'Allow with Other PG'],
|
|
],
|
|
'easy_pay_samsung_pay' => [
|
|
'type' => 'boolean',
|
|
'default' => false,
|
|
'label' => ['ko' => 'KG이니시스 삼성페이 사용', 'en' => 'Enable Samsung Pay (KG Inicis)'],
|
|
],
|
|
'easy_pay_naverpay' => [
|
|
'type' => 'boolean',
|
|
'default' => false,
|
|
'label' => ['ko' => 'KG이니시스 네이버페이 사용', 'en' => 'Enable Naver Pay (KG Inicis)'],
|
|
],
|
|
'easy_pay_show_brand_button' => [
|
|
'type' => 'boolean',
|
|
'default' => false,
|
|
'label' => ['ko' => '간편결제 브랜드 버튼 표시', 'en' => 'Show Easy Pay Branded Buttons'],
|
|
'hint' => [
|
|
'ko' => '활성화하면 주문서 결제수단에서 KG 이니시스 간편결제 버튼을 브랜드 아이콘과 짧은 설명으로 표시합니다.',
|
|
'en' => 'When enabled, checkout payment methods show KG Inicis easy pay brand icons and shorter descriptions.',
|
|
],
|
|
],
|
|
'easy_pay_lpay' => [
|
|
'type' => 'boolean',
|
|
'default' => false,
|
|
'label' => ['ko' => 'KG이니시스 L.pay 사용', 'en' => 'Enable L.pay (KG Inicis)'],
|
|
],
|
|
'easy_pay_kakaopay' => [
|
|
'type' => 'boolean',
|
|
'default' => false,
|
|
'label' => ['ko' => 'KG이니시스 카카오페이 사용', 'en' => 'Enable Kakao Pay (KG Inicis)'],
|
|
],
|
|
'use_credit_point' => [
|
|
'type' => 'boolean',
|
|
'default' => false,
|
|
'label' => ['ko' => '신용카드 포인트 사용', 'en' => 'Use Credit Card Points'],
|
|
],
|
|
];
|
|
}
|
|
|
|
public function getConfigValues(): array
|
|
{
|
|
$defaults = [
|
|
'is_test_mode' => true,
|
|
'test_mid' => 'INIpayTest',
|
|
'test_sign_key' => 'SU5JTElURV9UUklQTEVERVNfS0VZU1RS',
|
|
'test_iniapi_key' => 'ItEQKi3rY7uvDS8l',
|
|
'test_iniapi_iv' => 'HYb3yQ4f65QL89==',
|
|
'live_mid' => '',
|
|
'live_sign_key' => '',
|
|
'live_iniapi_key' => '',
|
|
'live_iniapi_iv' => '',
|
|
'test_mobile_hash_key' => '3CB8183A4BE283555ACC8363C0360223',
|
|
'live_mobile_hash_key' => '',
|
|
'use_escrow' => false,
|
|
'japan_enabled' => false,
|
|
'japan_restrict_jpy_payment_methods' => false,
|
|
'test_japan_sign_key' => '5AL5Djb1Ipualn0F',
|
|
'live_japan_mid' => '',
|
|
'live_japan_sign_key' => '',
|
|
'japan_merchant_name' => 'サンプルストア',
|
|
'japan_merchant_name_kana' => 'サンプルストア',
|
|
'japan_merchant_name_alphabet' => 'Sample Store',
|
|
'japan_merchant_name_short' => 'サンプル',
|
|
'japan_contact_name' => 'サポート窓口',
|
|
'japan_contact_email' => 'support@example.com',
|
|
'japan_contact_phone' => '0120-123-456',
|
|
'japan_contact_opening_hours' => '10:00-18:00',
|
|
'redirect_success_url' => '{shopBase}/orders/{orderId}/complete',
|
|
'redirect_fail_url' => '{shopBase}/checkout',
|
|
'easy_pay_allow_with_other_pg' => false,
|
|
'easy_pay_samsung_pay' => false,
|
|
'easy_pay_naverpay' => false,
|
|
'easy_pay_show_brand_button' => false,
|
|
'easy_pay_lpay' => false,
|
|
'easy_pay_kakaopay' => false,
|
|
'use_credit_point' => false,
|
|
];
|
|
|
|
return array_merge($defaults, $this->getJsonConfigDefaults());
|
|
}
|
|
|
|
/**
|
|
* config/settings/defaults.json 의 defaults 섹션을 런타임 기본값에도 반영한다.
|
|
*
|
|
* 플러그인 설치 초기값은 PluginManager 가 defaults.json 을 사용하지만,
|
|
* 저장 파일이 없는 환경의 PluginSettingsService fallback 은 getConfigValues() 를
|
|
* 사용하므로 두 경로의 기본값이 갈라지지 않도록 맞춘다.
|
|
*/
|
|
private function getJsonConfigDefaults(): array
|
|
{
|
|
$path = $this->getSettingsDefaultsPath();
|
|
if ($path === null || ! is_file($path)) {
|
|
return [];
|
|
}
|
|
|
|
$content = file_get_contents($path);
|
|
if ($content === false) {
|
|
return [];
|
|
}
|
|
|
|
$data = json_decode($content, true);
|
|
if (json_last_error() !== JSON_ERROR_NONE || ! is_array($data)) {
|
|
return [];
|
|
}
|
|
|
|
$defaults = $data['defaults'] ?? [];
|
|
|
|
return is_array($defaults) ? $defaults : [];
|
|
}
|
|
|
|
/**
|
|
* 이 플러그인이 등록할 HTTP 미들웨어 선언을 반환합니다.
|
|
*
|
|
* IP 화이트리스트(InicisNotifyIpWhitelist)는 서버 발신 webhook 라우트에만 부착합니다.
|
|
* 브라우저 POST 콜백(payment.callback 등)은 사용자 IP 라 대상에서 제외 — self 로 뭉치면
|
|
* 결제 회귀. 코어 ExtensionMiddlewareGate 가 요청 시점에 실행합니다.
|
|
*
|
|
* @return array<int, array{class: class-string, groups: array<int, string>, timing?: string, targets: array<int, string>}>
|
|
*/
|
|
public function getMiddleware(): array
|
|
{
|
|
return [
|
|
[
|
|
'class' => Http\Middleware\InicisNotifyIpWhitelist::class,
|
|
'groups' => ['web'],
|
|
'targets' => [
|
|
'web.plugins.sirsoft-pay_kginicis.payment.cbt.cvs-notify',
|
|
'web.plugins.sirsoft-pay_kginicis.payment.vbank-notify',
|
|
'web.plugins.sirsoft-pay_kginicis.payment.mobile.vbank-notify',
|
|
],
|
|
],
|
|
];
|
|
}
|
|
|
|
public function getHookListeners(): array
|
|
{
|
|
return [
|
|
Listeners\RegisterPgProviderListener::class,
|
|
Listeners\RegisterCashReceiptProviderListener::class,
|
|
Listeners\PaymentRefundListener::class,
|
|
Listeners\CancelActivityLogListener::class,
|
|
Listeners\RegisterEasyPayMethodsListener::class,
|
|
Listeners\AdjustEcommercePaymentMethodsLayoutListener::class,
|
|
Listeners\EnsureAdminOrderListTestBadgeLayoutListener::class,
|
|
Listeners\EnsureAdminOrderDetailTestModeLayoutListener::class,
|
|
Listeners\EnsureAdminOrderDetailPaymentQueryLayoutListener::class,
|
|
Listeners\RestoreLayoutExtensionsAfterUpdateListener::class,
|
|
Listeners\ValidateCbtSettingsListener::class,
|
|
];
|
|
}
|
|
|
|
public function getHooks(): array
|
|
{
|
|
return [
|
|
[
|
|
'name' => 'sirsoft-pay_kginicis.payment.before_authorize',
|
|
'type' => 'action',
|
|
'description' => [
|
|
'ko' => 'KG 이니시스 서버 승인 API 호출 전',
|
|
'en' => 'Before KG Inicis server authorization API call',
|
|
],
|
|
],
|
|
[
|
|
'name' => 'sirsoft-pay_kginicis.payment.after_authorize',
|
|
'type' => 'action',
|
|
'description' => [
|
|
'ko' => 'KG 이니시스 서버 승인 완료 후',
|
|
'en' => 'After KG Inicis server authorization completed',
|
|
],
|
|
],
|
|
[
|
|
'name' => 'sirsoft-pay_kginicis.payment.before_cancel',
|
|
'type' => 'action',
|
|
'description' => [
|
|
'ko' => 'KG 이니시스 결제 취소 API 호출 전 (본인인증 등 확장 지점)',
|
|
'en' => 'Before KG Inicis cancel API call (extension point for re-auth, etc.)',
|
|
],
|
|
],
|
|
[
|
|
'name' => 'sirsoft-pay_kginicis.payment.after_cancel',
|
|
'type' => 'action',
|
|
'description' => [
|
|
'ko' => 'KG 이니시스 결제 취소 완료 후',
|
|
'en' => 'After KG Inicis cancel completed',
|
|
],
|
|
],
|
|
[
|
|
'name' => 'sirsoft-pay_kginicis.payment.before_cbt_refund',
|
|
'type' => 'action',
|
|
'description' => [
|
|
'ko' => 'KG 이니시스 일본 CBT 결제 취소 API 호출 전',
|
|
'en' => 'Before KG Inicis Japan CBT refund API call',
|
|
],
|
|
],
|
|
[
|
|
'name' => 'sirsoft-pay_kginicis.payment.after_cbt_refund',
|
|
'type' => 'action',
|
|
'description' => [
|
|
'ko' => 'KG 이니시스 일본 CBT 결제 취소 완료 후',
|
|
'en' => 'After KG Inicis Japan CBT refund completed',
|
|
],
|
|
],
|
|
];
|
|
}
|
|
}
|