# NMI 연동 설정 방법

NMI(Network Merchants Inc.)는 비즈니스가 온라인 거래를 안전하고 효율적으로 처리할 수 있는 다양한 솔루션을 제공하는 잘 알려진 결제 게이트웨이 서비스 제공업체입니다. NMI의 결제 게이트웨이를 통해 판매자는 웹사이트, 모바일 앱, 매장 내 POS 시스템 등 여러 채널을 통해 고객으로부터 신용카드 및 eCheck 결제를 받을 수 있습니다.

#### 이 문서에서 다루는 내용:

#### [NMI가 제공하는 기능은 무엇인가요?](#nmi가-제공하는-기능은-무엇인가요)

#### [NMI를 통한 결제를 어떻게 활성화할 수 있나요?](#nmi를-통한-결제를-어떻게-활성화할-수-있나요)

#### [NMI에서 필요한 게이트웨이 ID와 API 키 입력하기:](#nmi에서-필요한-게이트웨이-id와-api-키-입력하기)

#### [자주 묻는 질문](#자주-묻는-질문)

* [**NMI 연동을 어디서 사용해 결제를 받을 수 있나요?**](#nmi-연동을-어디서-사용해-결제를-받을-수-있나요)
* [**연동을 위해 새로운 상품을 만들어야 하나요? 결제 제공업체와 상품을 어떻게 동기화해야 하나요?**](#연동을-위해-새로운-상품을-만들어야-하나요-결제-제공업체와-상품을-어떻게-동기화해야-하나요)
* [**NMI에서 지원하는 결제 방법은 무엇인가요? Apple Pay, Google Pay, eCheck 결제 방법이 지원되나요?**](#nmi에서-지원하는-결제-방법은-무엇인가요-apple-pay-google-pay-echeck-결제-방법이-지원되나요)
* [**NMI 연동에서 3DS가 지원되나요?**](#nmi-연동에서-3ds가-지원되나요)
* [**Google Pay와 Apple Pay 제공은 Stripe을 사용하고 신용카드 결제 처리는 NMI/Authorize.net을 사용할 수 있나요?**](#google-pay와-apple-pay-제공은-stripe을-사용하고-신용카드-결제-처리는-nmiauthorizenet을-사용할-수-있나요)
* [**NMI에서 정기 구매가 지원되나요? 구독과 주문 추적은 어디서 찾을 수 있나요?**](#nmi에서-정기-구매가-지원되나요-구독과-주문-추적은-어디서-찾을-수-있나요)
* [**이미 Stripe을 사용하고 있습니다. NMI 연결을 위해 Stripe을 연결 해제해야 하나요?**](#이미-stripe을-사용하고-있습니다-nmi-연결을-위해-stripe을-연결-해제해야-하나요)
* [**연동(Integrations) 페이지 상단의 기본 게이트웨이는 무엇을 의미하나요?**](#연동integrations-페이지-상단의-기본-게이트웨이는-무엇을-의미하나요)
* [**기본 게이트웨이 옵션에 PayPal이 보이지 않는 이유는 무엇인가요?**](#기본-게이트웨이-옵션에-paypal이-보이지-않는-이유는-무엇인가요)
* [**NMI를 연결하고 기본 게이트웨이로 선택했습니다. 이제 애플리케이션 전반의 거래가 NMI를 통해 처리되나요?**](#nmi를-연결하고-기본-게이트웨이로-선택했습니다-이제-애플리케이션-전반의-거래가-nmi를-통해-처리되나요)
* [**Authorize.net으로 처리된 거래 보고에는 어떤 변화가 있나요? 모든 결제를 어디서 추적할 수 있나요?**](#authorizenet으로-처리된-거래-보고에는-어떤-변화가-있나요-모든-결제를-어디서-추적할-수-있나요)
* [**NMI/Authorize.net을 통해 생성된 구독을 취소/종료하려면 어떻게 하나요? 판매자 포털에서는 할 수 없습니다.**](#nmiauthorizenet을-통해-생성된-구독을-취소종료하려면-어떻게-하나요-판매자-포털에서는-할-수-없습니다)
* [**애플리케이션 내에서도 거래 환불이 가능한가요?**](#애플리케이션-내에서도-거래-환불이-가능한가요)
* [**NMI를 통해 생성된 구독은 어디서 찾을 수 있나요? 구독(Subscriptions) 페이지에 정의된 구독 상태를 이해할 수 없습니다.**](#nmi를-통해-생성된-구독은-어디서-찾을-수-있나요-구독subscriptions-페이지에-정의된-구독-상태를-이해할-수-없습니다)
* [**NMI 연동이 캘린더 결제/멤버십 및 기타 영역에서 언제 사용 가능해지나요?**](#nmi-연동이-캘린더-결제멤버십-및-기타-영역에서-언제-사용-가능해지나요)

#### [참고 추가 자료](#참고-추가-자료)

## NMI가 제공하는 기능은 무엇인가요?

NMI 결제 게이트웨이가 제공하는 주요 기능은 다음과 같습니다:

* 다중 통화 및 결제 방법 지원: NMI는 다양한 통화와 결제 방법을 지원하여 비즈니스가 전 세계 고객을 대상으로 할 수 있도록 돕습니다.
* 토큰화 및 암호화: NMI 플랫폼은 토큰화 및 암호화 기술을 사용하여 민감한 카드 소유자 정보를 안전하게 전송하고 저장하며, 사기 및 데이터 유출 위험을 최소화합니다.
* 사기 방지 도구: NMI는 주소 확인 시스템(AVS) 및 카드 확인 값(CVV) 같은 다양한 사기 방지 도구를 제공하여 판매자가 잠재적으로 사기성 거래를 식별하고 차단할 수 있도록 돕습니다.
* 맞춤형 결제 경험: 판매자는 자신의 브랜딩에 맞게 결제 프로세스의 외관과 느낌을 맞춤화하여 원활한 고객 경험을 보장할 수 있습니다.
* 정기 청구 및 구독 관리: NMI는 정기 청구와 구독 관리를 지원하여 비즈니스가 구독 기반 제품이나 서비스를 쉽게 제공할 수 있도록 합니다.
* 연동 옵션: NMI는 API와 미리 제작된 플러그인을 포함한 다양한 연동 옵션을 제공하여 결제 게이트웨이를 다양한 전자상거래 플랫폼, 쇼핑카트, 기타 서드파티 소프트웨어에 쉽게 연결할 수 있습니다.
* 보고서 및 분석: NMI 플랫폼은 판매자가 거래 데이터를 추적하고 분석할 수 있는 포괄적인 보고서 및 분석 도구를 제공하여 정보에 기반한 비즈니스 결정을 내릴 수 있도록 돕습니다.
* 고객 저장소: 판매자는 고객의 결제 정보를 NMI의 고객 저장소에 안전하게 저장하여 재방문 고객의 결제 프로세스를 단순화하고 정기 결제를 쉽게 관리할 수 있습니다.

## NMI를 통한 결제를 어떻게 활성화할 수 있나요?

NMI 연동은 현재 주문 양식, 인보이스(Invoice), Text2Pay 링크 결제에서 지원됩니다. 다음 단계를 통해 연동을 활성화할 수 있습니다:

### NMI에서 필요한 게이트웨이 ID와 API 키 입력하기:

NMI 연결을 위해 다음 세 가지 키를 입력해야 합니다:

* Gateway Id
* Security key
* Public key

계정의 게이트웨이 ID를 가져오려면 판매자 계정으로 이동하세요. 설정(Settings) → 계정 정보(Account Information)로 이동하면 계정의 게이트웨이 ID를 찾을 수 있습니다.

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155009301743/original/rAL5-NYa4qQf3QBMONTERfueR0uwXpP_NQ.png?1696491980)

키를 아직 가지고 있지 않다면 [이 지침](https://support.nmi.com/hc/en-gb/articles/360002575497-Security-Keys-)을 따라 키를 획득하세요.

키를 획득했으면 하위 계정에서 결제(Payments) > 연동(Integrations)으로 이동하세요.

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155055145880/original/E3MNPQeKENQ1_TkBc3olzeqtm4wy7NERTA.png?1759474834)

그다음 해당 필드에 키를 입력하고 저장(Save)을 클릭하세요:

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155055145862/original/GEsjIJ5Cnj4ZF7U-KcExrvXVvn1xHowX-Q.png?1759474803)

참고사항: 이 기능을 사용하려면 퍼널 버전 2로 업그레이드하세요.

## 자주 묻는 질문

### NMI 연동을 어디서 사용해 결제를 받을 수 있나요?

NMI 연동은 퍼널 버전 2의 주문 양식 결제를 처리할 수 있습니다. 여기에는 원스텝 및 투스텝 주문 양식과 원클릭 업셀이 포함됩니다. 인보이스 결제는 NMI 연동을 사용해 처리할 수 있으며, Text2Pay 링크 결제도 NMI 연동을 사용해 처리할 수 있습니다.

### 연동을 위해 새로운 상품을 만들어야 하나요? 결제 제공업체와 상품을 어떻게 동기화해야 하나요?

NMI/Authorize.net 연동을 사용하기 위해 상품 동기화는 전혀 필요하지 않습니다. 결제(Payments) → 상품(Products) 아래에 상품(일회성/정기)을 만들기만 하면 되며, 상품 생성/편집 시 정의한 가격에 따라 작동합니다.

기존 상품이 Stripe/PayPal과 함께 사용되고 있다면, 결제(Payments) → 연동(Integrations) 아래에서 기본 제공업체를 전환하여 Authorize.net이나 NMI와 함께 작동할 것입니다. 이 경우 추가 동기화는 필요하지 않습니다.

### NMI에서 지원하는 결제 방법은 무엇인가요? Apple Pay, Google Pay, eCheck 결제 방법이 지원되나요?

NMI 연동을 사용하면 신용카드/직불카드 결제만 받을 수 있습니다. 현재 Apple Pay, Google Pay 또는 수표 결제 방법은 받을 수 없습니다.

### NMI 연동에서 3DS가 지원되나요?

네, 2025년 9월에 3DS 지원을 추가했으며 3DS가 필요한 모든 카드는 NMI와 원활하게 작동해야 합니다. 3DS를 활성화하려면 일회성 설정이 필요합니다:

* NMI 계정에서 Payer Authentication 2.0을 등록하세요
* 서비스 상태가 활성(Active)인지 확인하세요
* NMI 판매자 포털에서 3DS용 결제 공개 키를 생성하고, HighLevel 연동에 추가하세요 (스크린샷 참조)

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155055146064/original/lnR5pkHGs_XvDknDgiOtDSo0tDxYIsMACA.png?1759474978)

### Google Pay와 Apple Pay 제공은 Stripe을 사용하고 신용카드 결제 처리는 NMI/Authorize.net을 사용할 수 있나요?

안타깝게도 그렇게 할 수 없습니다. Google Pay와 Apple Pay는 현재 Stripe을 통해서만 제공할 수 있으며, Stripe, Authorize.net, NMI 중 주문 양식 결제를 위해서는 하나의 게이트웨이만 기본값으로 설정해야 합니다. 따라서 동시에 사용하는 것은 불가능합니다.

### NMI에서 정기 구매가 지원되나요? 구독과 주문 추적은 어디서 찾을 수 있나요?

네, NMI/Authorize.net 연동을 사용하여 정기 상품 구매가 지원됩니다. 결제(Payments) → 구독(Subscriptions) 아래에서 구독을 추적하고 주문 및 거래(Orders and Transactions) 표에서 주문 세부 정보를 확인할 수 있습니다.

참고사항: 주문 양식 결제에서는 한 번에 하나의 정기 상품만 구매하는 것이 지원됩니다.

### 이미 Stripe을 사용하고 있습니다. NMI 연결을 위해 Stripe을 연결 해제해야 하나요?

아니요, NMI 연결을 위해 Stripe을 연결 해제할 필요는 없습니다. 연동 페이지에서 두 게이트웨이 모두에 연결할 수 있습니다. 하지만 결제 처리를 위해 두 개의 게이트웨이가 연결되었으므로 주문 양식 결제 처리를 위한 기본 게이트웨이를 정의해야 합니다.

### 연동(Integrations) 페이지 상단의 기본 게이트웨이는 무엇을 의미하나요?

연동 페이지에서 두 개 이상의 게이트웨이에 연결하면 결제 처리를 위한 기본 게이트웨이를 정의해야 합니다. 이는 결제 처리가 가능한 게이트웨이가 둘 이상 있고 기본 선택이 필요하기 때문입니다. 하나의 기본 선택을 해야 합니다.

참고사항: PayPal은 기본값으로 설정된 Authorize.net/Stripe와 함께 계속 작동합니다.

### 기본 게이트웨이 옵션에 PayPal이 보이지 않는 이유는 무엇인가요?

PayPal에 연결하여 Stripe/Authorize.net/NMI를 사용한 신용카드 결제 방법과 함께 결제 방법으로 사용할 수 있습니다. 즉, 연결 시 Stripe/Authorize.net/NMI 중에서 기본값을 선택해야 합니다. PayPal은 주문 양식에서 독립적으로 그리고 신용카드 결제 방법과 함께 사용할 수 있습니다.

### NMI를 연결하고 기본 게이트웨이로 선택했습니다. 이제 애플리케이션 전반의 거래가 NMI를 통해 처리되나요?

NMI 연동은 인보이스, text2pay 링크, 주문 양식 결제에만 사용할 수 있습니다. 즉, NMI가 연결되고 기본 게이트웨이로 설정된 경우 이러한 결제만 NMI를 통해 처리됩니다. 캘린더, SaaS, 멤버십과 같은 다른 결제 영역은 계속해서 Stripe을 사용하여 결제를 처리합니다.

참고사항: Stripe으로 진행 중인 정기 구독/대기 중인 거래가 있다면, Stripe 연결이 유지되는 동안 그대로 계속 실행됩니다. 연결을 유지하고 어떤 게이트웨이도 연결 해제하지 않기를 권장하며, 기본 게이트웨이를 정의하면 새로운 거래는 원하는 선택을 통해 실행되고 Stripe 및/또는 PayPal을 통해 실행되는 기존 구독을 그대로 유지합니다.

### Authorize.net으로 처리된 거래 보고에는 어떤 변화가 있나요? 모든 결제를 어디서 추적할 수 있나요?

주문/구독/거래 보고에는 변화가 없습니다. NMI/Authorize.net을 통해 처리된 모든 결제는 결제(Payments) → 거래(Transactions) 아래에서 확인할 수 있습니다.

또한 주문 양식과 관련된 트리거/어트리뷰션 작동에도 변화가 없습니다. 모든 기능이 동일하게 작동합니다.

### NMI/Authorize.net을 통해 생성된 구독을 취소/종료하려면 어떻게 하나요? 판매자 포털에서는 할 수 없습니다.

NMI/Authorize.net을 사용하여 생성된 구독은 구독 페이지에서 '구독 취소(Cancel Subscription)' 액션을 사용하여 취소할 수 있습니다.

NMI/Authorize.net의 자동 정기 청구를 사용하여 구독을 생성하지 않으므로, 판매자 포털에는 구독 거래에 해당하는 요금만 표시됩니다.

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/48288347406/original/YtFY83ed7ZtWjAFLD3E8ygzDbZSVTGi21A.jpeg?1679385093)

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/48288347404/original/x56TQ8bObLZcmOHAAoV47f2txbSH9Rah5g.jpeg?1679385092)

### 애플리케이션 내에서도 거래 환불이 가능한가요?

아니요, 현재로서는 애플리케이션 내에 환불 기능이 없습니다. 지금은 거래 환불을 위해 판매자 포털을 사용하는 것이 좋습니다.

### NMI를 통해 생성된 구독은 어디서 찾을 수 있나요? 구독(Subscriptions) 페이지에 정의된 구독 상태를 이해할 수 없습니다.

주문 양식에서 생성된 모든 구독은 결제(Payments) → 구독(Subscriptions) 아래에서 추적할 수 있습니다. 다음은 구독 상태와 그 의미를 나타냅니다:

대기(Pending) - 구독의 첫 번째 거래를 완료할 수 없거나 거래가 검토를 위해 보류 중일 때

체험(Trial) - 구독이 체험 모드에 있을 때

활성(Active) - 마지막 결제가 완료되었고 다음 결제 예정이 있을 때

만료(Expired) - 모든 구독 결제가 완료되어 구독이 더 이상 존재하지 않을 때

취소(Canceled) - 비즈니스가 취소 액션을 사용하여 구독을 취소했으며 더 이상 결제가 처리되지 않을 때

미납(Unpaid) - 구독의 마지막 결제가 성공적으로 이루어지지 않았을 때. 구독은 진행 중이지만 최종 결제가 실패했을 때

다음 액션은 상태에 따라 구독에 제공됩니다:

| 액션/상태 | 대기  | 체험 | 활성 | 만료  | 취소  | 미납 |
| ----- | --- | -- | -- | --- | --- | -- |
| 취소    | 아니요 | 예  | 예  | 아니요 | 아니요 | 예  |

다음 플로우는 후속 결제 실패 시 구독 상태 처리 및 결제 재시도 로직을 설명합니다:

주문 양식에서 구독 구매 시 첫 번째 구독 결제가 성공하면 구독은 활성 상태로 전환됩니다. 정기 상품에 체험 기간이 첨부되어 있다면 체험 상태로 전환될 수도 있습니다. 구독은 모든 정기 결제가 성공적으로 이루어질 때까지 활성 상태를 유지하며 결제 완료 후 "만료"로 전환됩니다.

결제는 각각 24시간 후에 두 번 더 시도됩니다. 상태는 "미납"으로 유지됩니다.

구독은 미납 상태로 유지되며 각각 두 번의 재시도를 포함하여 다음 후속 거래를 시도합니다. 다음 후속 결제도 시도되며, 어떤 결제든 성공하면 구독은 "활성"으로 전환됩니다. 그렇지 않으면 "미납" 상태를 유지합니다.

마지막 거래에 대한 모든 재시도가 완료되면 구독 상태는 "만료"로 전환됩니다.

비즈니스가 게이트웨이 계정을 연결 해제하고 진행 중인 구독이 있다면, 거래를 처리할 수 없어 구독이 미납으로 전환됩니다. 재시도 로직에 따라 재시도 시도는 계속됩니다.

### 참고 추가 자료

[NMI 테스트 카드](https://support.nmi.com/hc/en-gb/articles/115002375583-Test-Cards)

[NMI 사용 가능 통화](https://support.nmi.com/hc/en-gb/articles/360005072012-Available-Currencies-Currency-Selection#Querying%20Available%20Currencies)

***

*원문 최종 수정: 2025-10-03* *Hyperclass 사용 가이드 — hyperclass.ai*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hyperclass.gitbook.io/hyperclass-docs/payments/how-to-set-up-the-nmi-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.