Guide / 결제 제공업체
KO EN

결제 제공업체

결제 제공업체 페이지는 iBoard 결제 시스템에서 사용할 결제 회사의 기본 정보를 등록하고 관리하는 화면입니다.

Payment Providers에서는 Stripe, Authorize.Net 같은 결제 회사의 기본 정보를 등록합니다. 실제 API Key, Secret Key, Webhook URL, 운영 환경, 가맹점 계정 정보 같은 상세 연결 정보는 Payment Configs 메뉴에서 입력합니다.

화면 개요

Payment Providers는 결제 회사 목록을 관리하는 기본 마스터 메뉴입니다. 여기에서는 결제 제공업체의 코드, 이름, 활성 상태, 정렬 순서, 내부 메모를 관리합니다.

일반적으로 이 화면에는 민감한 결제 인증 정보를 직접 저장하지 않습니다. 각 결제 회사의 실제 연결 정보는 Payment Configs에서 관리하는 것이 좋습니다.

메뉴 목적
Payment Providers 결제 회사의 기본 정보, 제공업체 코드, 이름, 활성 상태, 정렬 순서를 등록합니다.
Payment Configs API 인증 정보, 운영 모드, 가맹점 계정, 연결 옵션 같은 상세 결제 설정을 저장합니다.

Provider 목록

Provider 목록에서는 등록된 결제 제공업체를 확인할 수 있습니다. 이 화면에서 새 제공업체를 추가하거나, 기존 제공업체를 수정, 삭제, 활성화, 필터링할 수 있습니다.

상단 버튼

버튼 설명
+ New 새 결제 제공업체를 등록하기 위해 Provider Edit 화면을 엽니다.
Only Active 활성화된 결제 제공업체만 표시합니다.
Show All 활성 및 비활성 결제 제공업체를 모두 표시합니다.
Seed Defaults Stripe, Authorize.Net 같은 기본 결제 제공업체를 생성하거나 복원합니다.

Provider 테이블

컬럼 설명
ID 내부 제공업체 ID입니다.
Code STRIPE, AUTHNET 같은 고유 제공업체 코드입니다.
Name 결제 제공업체 표시 이름입니다.
Active 현재 제공업체가 활성 상태인지 비활성 상태인지 표시합니다.
Sort 제공업체 표시 순서를 결정합니다.
Updated 마지막 수정 날짜와 시간입니다.
Manage Edit, Delete 작업을 제공합니다.

Provider Edit

Provider Edit 화면은 결제 제공업체의 기본 정보를 새로 등록하거나 수정할 때 사용합니다.

ProviderName Select

드롭다운에서 미리 정의된 결제 제공업체를 선택합니다. 제공업체를 선택하면 ProviderCode가 자동으로 입력될 수 있습니다.

일반적인 제공업체 예시는 다음과 같습니다.

  • Stripe
  • Authorize.Net
  • Other (Custom)

ProviderName Custom

Other (Custom)을 선택한 경우에만 사용하는 입력 항목입니다. 직접 사용할 결제 제공업체 이름을 입력합니다. 

예:
MyGateway
CustomPay
LocalMerchantProvider

ProviderCode

ProviderCode는 시스템 내부에서 결제 제공업체를 식별하는 고유 코드입니다. 대문자 영문, 숫자, 언더스코어 조합을 사용하는 것을 권장합니다. 

권장:
STRIPE
AUTHNET
MY_GATEWAY
CUSTOM_PAY

피해야 할 예:
Stripe Payment
my gateway!!
custom-provider-name-with-spaces
ProviderCode는 Payment Configs 또는 거래 기록에서 참조될 수 있으므로 한 번 사용한 뒤에는 가능하면 변경하지 않는 것이 좋습니다.

IsActive

해당 결제 제공업체를 사용할 수 있는지 여부를 설정합니다.

값 의미
true 제공업체가 활성 상태이며 결제 설정에서 사용할 수 있습니다.
false 제공업체가 비활성 상태이며 새 결제 설정에 사용하지 않는 것이 좋습니다.

SortOrder

SortOrder는 결제 제공업체의 표시 순서를 결정합니다. 일반적으로 숫자가 작을수록 먼저 표시됩니다. 

예:
10 - Stripe
20 - Authorize.Net
30 - Custom Gateway

Notes

Notes에는 제공업체에 대한 내부 참고 정보를 입력할 수 있습니다. Secret Key, API Password 같은 민감한 정보는 Notes에 저장하지 않는 것이 좋습니다.

권장 작업 순서

  1. Admin > Payment > Providers 메뉴로 이동합니다.
  2. 기본 제공업체가 없다면 Seed Defaults 버튼을 클릭합니다.
  3. 새 제공업체를 추가하려면 + New를 클릭하고, 기존 제공업체를 수정하려면 Edit를 클릭합니다.
  4. 미리 정의된 제공업체를 선택하거나 Other (Custom)을 선택합니다.
  5. ProviderCode를 확인하거나 직접 입력합니다.
  6. 사용할 제공업체라면 IsActive를 true로 설정합니다.
  7. SortOrder를 입력합니다.
  8. 필요한 경우 내부 메모를 입력합니다.
  9. Save 버튼을 클릭합니다.
  10. Payment > Configs로 이동하여 상세 결제 연결 정보를 입력합니다.

Providers와 Configs의 관계

Provider는 결제 회사를 식별하는 기본 정보이고, Config는 실제 결제 연결에 필요한 상세 설정입니다.

정보 유형 관리 위치
결제 회사 이름 Payment Providers
ProviderCode Payment Providers
활성/비활성 상태 Payment Providers
API Key Payment Configs
Secret Key Payment Configs
Merchant ID Payment Configs
Sandbox 또는 Production 모드 Payment Configs
Webhook 또는 Callback 설정 Payment Configs

자주 사용하는 작업

상황 권장 작업
Stripe 제공업체 추가 Stripe를 선택하고 ProviderCode가 STRIPE인지 확인한 뒤 활성화하고 저장합니다.
Authorize.Net 추가 Authorize.Net을 선택하고 ProviderCode가 AUTHNET인지 확인한 뒤 활성화하고 저장합니다.
커스텀 결제 게이트웨이 추가 Other (Custom)을 선택하고 제공업체 이름과 고유 ProviderCode를 입력한 뒤 저장합니다.
제공업체 임시 비활성화 Provider를 수정하여 IsActive를 false로 변경합니다.
기본 제공업체 복원 Seed Defaults 버튼을 클릭합니다.

주의사항

  • Provider는 결제 회사의 기본 정보만 저장하는 영역입니다.
  • API Key, Secret Key, Webhook 같은 상세 정보는 Payment Configs에서 관리하세요.
  • Notes에는 비밀번호, Secret Key, Private Key 같은 민감한 정보를 저장하지 마세요.
  • ProviderCode는 Payment Configs나 결제 거래 기록에서 참조될 수 있으므로 안정적으로 유지하는 것이 좋습니다.
  • 비활성 Provider는 새 결제 설정에서 사용하지 않는 것이 좋습니다.
  • Provider를 삭제하기 전에는 연결된 Config나 거래 기록이 없는지 확인해야 합니다.

문제 해결

문제 가능한 원인 해결 방법
결제 설정에서 Provider가 보이지 않음 Provider가 비활성 상태일 수 있습니다. Provider를 수정하고 IsActive를 true로 설정합니다.
ProviderCode가 비어 있음 커스텀 Provider를 선택했지만 코드를 입력하지 않았을 수 있습니다. 고유한 ProviderCode를 입력하거나 가능한 경우 Auto 버튼을 사용합니다.
기본 Provider가 없음 기본 제공업체 데이터가 아직 생성되지 않았을 수 있습니다. Seed Defaults 버튼을 클릭합니다.
Provider를 추가했는데 결제가 작동하지 않음 Provider 기본 정보만 추가되고 상세 Config 정보가 입력되지 않았을 수 있습니다. Payment > Configs로 이동하여 필요한 결제 연결 정보를 입력합니다.
Provider 삭제가 안 됨 기존 Config나 거래 기록에서 해당 Provider를 참조하고 있을 수 있습니다. 삭제 대신 비활성화하거나, 의존된 Config를 먼저 정리합니다.

관리 권장 사항

  • Payment Configs를 만들기 전에 Provider를 먼저 등록하거나 확인하세요.
  • STRIPE, AUTHNET처럼 명확하고 안정적인 ProviderCode를 사용하세요.
  • 현재 사용 가능한 제공업체만 보고 싶다면 Only Active를 사용하세요.
  • 기본 Provider가 없거나 복원이 필요할 때만 Seed Defaults를 사용하세요.
  • 인증 정보는 Payment Providers가 아니라 Payment Configs에 저장하세요.
  • 거래 기록이 남아 있을 가능성이 있다면 삭제보다 비활성화를 권장합니다.
Payment Providers는 결제 회사를 정의하는 영역이고, Payment Configs는 해당 회사와 실제 가맹점 계정을 연결하는 영역입니다. 실제 결제를 받기 전에는 두 설정이 모두 올바르게 구성되어 있어야 합니다.