결제 설정

결제 설정 페이지는 결제 제공업체와 환경별로 실제 결제 연결 정보를 관리하는 화면입니다. 결제를 처리하기 위해 필요한 상세 설정값을 입력하는 곳입니다.

Payment Providers에서는 Stripe, Authorize.Net 같은 결제 회사를 등록합니다. Payment Configs에서는 API Key, Transaction Key, Webhook Secret, 환경, 도메인 URL, Capture Mode, 3DS, 추가 Meta 설정 같은 상세 결제 정보를 입력합니다.

화면 개요

Payment Configs는 환경별 결제 설정입니다. 하나의 결제 제공업체는 TEST용 설정과 LIVE용 설정을 각각 가질 수 있습니다.

Config 목록

Config 목록에서는 결제 제공업체, 환경, 표시 이름, MerchantKey, 3DS 상태, Capture Mode, 활성 상태, 마지막 수정일을 확인할 수 있습니다.

상단 기능

Config 테이블

Config Edit

Config Edit 화면은 결제 게이트웨이의 상세 설정을 새로 만들거나 수정할 때 사용합니다. 화면은 Core, Keys, Advanced, Summary 영역으로 구성됩니다.

Core 영역

Core 영역에서는 제공업체, 환경, 활성 상태, MerchantKey, DisplayName을 설정합니다.

Provider

설정할 결제 제공업체를 선택합니다. Provider를 선택하면 시스템이 해당 제공업체에 필요한 입력 항목만 자동으로 보여줄 수 있습니다.

Stripe, Authorize.Net 같은 기본 제공업체에는 기본 규칙이 적용됩니다.

Environment

Environment는 이 설정이 테스트 결제용인지 실제 결제용인지 결정합니다.

IsActive

IsActive가 true이면 이 설정을 사용할 수 있습니다. false이면 해당 설정은 비활성화됩니다.

Keys 영역

Keys 영역에는 제공업체별 인증 및 연결 값을 저장합니다. 선택한 Provider에 따라 입력 항목의 의미가 달라질 수 있습니다.

Stripe에서는 일반적으로 pk/sk/whsec 값을 사용합니다. Authorize.Net에서는 일반적으로 LoginId와 TransactionKey를 사용합니다.

ApiKeyPublic

결제 게이트웨이에서 제공하는 Public Key, Publishable Key 또는 API Login ID를 입력합니다.

ApiKeySecret

결제 게이트웨이에서 제공하는 Secret Key, Private Key 또는 Transaction Key를 입력합니다. 이 값은 외부에 노출되면 안 됩니다.

WebhookSecret

결제 제공업체가 Webhook 검증을 사용하는 경우 Webhook Signature Secret을 입력합니다. 이 값은 실제 결제 제공업체가 보낸 요청인지 확인하는 데 사용됩니다.

EndpointBaseUrl

결제 흐름에서 사용할 기본 도메인을 입력합니다.

예:
https://your-domain.com
https://your-ngrok-domain.ngrok-free.dev

로컬 테스트에서는 ngrok 같은 임시 공개 URL을 사용할 수 있습니다. 운영 환경에서는 반드시 HTTPS가 적용된 실제 웹사이트 도메인을 사용하는 것이 좋습니다.

Advanced 영역

Advanced 영역에서는 결제 정책, 위험 수준, 캡처 방식, 3DS, 정산일, MetaJson, 내부 메모를 관리합니다.

Currency

이 결제 설정에서 사용할 통화를 선택합니다.

예:
USD - US Dollar

RiskLevel

RiskLevel은 이 결제 설정의 위험 정책을 구분하기 위한 내부 값입니다. 일반적으로 낮은 값은 낮은 위험, 높은 값은 더 엄격한 검토가 필요할 수 있음을 의미합니다.

SettlementDays

SettlementDays는 결제 금액이 정산되기까지 예상되는 일수입니다. 실제 정산 기간은 결제 제공업체와 가맹점 계정 설정에 따라 달라질 수 있습니다.

Enable3DS

Enable3DS는 3D Secure 인증 사용 여부를 결정합니다. 항목이 비활성화되어 있다면 현재 선택한 제공업체 또는 환경에서 3DS를 지원하지 않을 수 있습니다.

CaptureMode

CaptureMode는 결제를 언제 캡처할지 결정합니다.

MetaJson

MetaJson은 별도의 입력 항목이 없는 추가 설정값을 JSON 형식으로 저장하는 영역입니다. 이 필드는 반드시 올바른 JSON 형식이어야 합니다.

{
    "hostedPaymentPageId": "12345678",
    "returnPath": "/ShowPage/iCheckout/Return",
    "cancelPath": "/ShowPage/iCheckout/Cancel",
    "transactionType": "authCaptureTransaction",
    "showReceipt": true
}

자주 사용하는 MetaJson 항목

MetaJson은 반드시 유효한 JSON이어야 합니다. JSON 형식이 잘못되면 결제 설정이 정상적으로 동작하지 않을 수 있습니다.

Summary 패널

Summary 패널은 현재 설정 상태를 빠르게 확인할 수 있는 영역입니다. 선택된 Provider, ProviderCode, Environment, Active 상태를 보여줍니다.

저장하기 전에 Summary 패널에서 선택한 제공업체와 환경이 맞는지 확인하는 것이 좋습니다.

권장 작업 순서

1. Admin > Payment > Configs 메뉴로 이동합니다.
2. 새 설정을 만들려면 + New를 클릭하고, 기존 설정을 수정하려면 Edit를 클릭합니다.
3. Provider를 선택합니다.
4. Environment를 TEST 또는 LIVE로 선택합니다.
5. IsActive 상태를 설정합니다.
6. MerchantKey와 DisplayName을 입력합니다.
7. Keys 영역에 제공업체별 키 정보를 입력합니다.
8. EndpointBaseUrl을 입력합니다.
9. Currency, RiskLevel, SettlementDays, 3DS, CaptureMode를 설정합니다.
10. 추가 설정이 필요하면 올바른 JSON 형식으로 MetaJson을 입력합니다.
11. Summary 패널을 확인합니다.
12. Save 버튼을 클릭합니다.
13. LIVE 환경에서 사용하기 전 TEST 환경에서 결제 흐름을 검증합니다.

자주 사용하는 작업

주의사항

• Payment Configs에는 민감한 결제 연결 정보가 저장됩니다. 신뢰할 수 있는 관리자만 접근할 수 있어야 합니다.
• LIVE 환경을 사용하기 전에 반드시 TEST 환경에서 결제 설정을 검증하세요.
• 운영용 EndpointBaseUrl은 반드시 HTTPS를 사용하는 것이 좋습니다.
• Secret Key는 Notes가 아니라 지정된 Key 입력 항목에 저장하세요.
• 저장 전 MetaJson이 올바른 JSON 형식인지 확인하세요.
• 기존 거래와 연결된 Config는 영향 범위를 이해하지 못한 상태에서 삭제하지 않는 것이 좋습니다.
• 같은 Provider에 여러 Config가 있을 경우 DisplayName을 명확하게 작성하세요.

문제 해결

관리 권장 사항

• TEST용 Config와 LIVE용 Config를 분리해서 관리하세요.
• Authorize.Net (Test), Authorize.Net (Live)처럼 DisplayName을 명확하게 작성하세요.
• 거래 기록이 남아 있다면 오래된 Config는 삭제보다 비활성화를 권장합니다.
• 결제 제공업체의 보안 정책에 따라 주기적으로 Key를 교체하세요.
• 도메인, 체크아웃 URL, Webhook 설정이 변경되면 Config 값을 다시 확인하세요.
• 이 화면에는 민감한 결제 설정이 포함되므로 접근 권한을 제한하세요.

Payment Configs는 실제 결제 처리를 위해 반드시 필요한 설정입니다. Provider는 결제 회사를 정의하고, Config는 iBoard가 특정 환경에서 그 회사와 어떻게 연결되는지를 정의합니다.