> For the complete documentation index, see [llms.txt](https://docs.ohmyapp.io/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ohmyapp.io/main/guide/faq/payment_api/1.md).

# 1. 포트원 결제 연동은 어떻게 하나요?

오마이앱은 사용자 편의를 위해 각 플랫폼에 명시되어 있는 내용을 간추려서 제공하고 있어요. 상세한 내용 또는 실제 관련 문의사항은 해당 플랫폼에 문의해 주세요.

***

결제와 본인 인증을 위해서 포트원에 가입해 주세요.

##  **포트원 가입**

* 포트원은 국내 PG결제 모듈 연동을 쉽게 해주는 결제 API 서비스예요.
* 포트원을 통해 결제 모듈을 연동하며 PG사 가입도 가능해요.
* [포트원 가입 링크](https://portone.io/korea/ko)<br>

#### 참고사항

* 스타트업 서비스의 경우 PG사 가입이 한 번에 승인되지 않을 수 있어요. 해당 고객센터에 문의 후 서류를 보완하여 다시 가입신청을 진행하면 돼요.
* PG사 마다 상이하나 앱 서비스의 경우 주로 결제 프로세스를 캡쳐(KG 이니시스 기준)하여 전달해요.
* 서비스가 어느 정도 완성 된 이후에 PG사 승인이 가능해요. (서비스 완성 전에는 PG사 승인이 나지 않음)
* 단일 결제(건 별 결제)는 비교적 승인이 빨라요. (1-2주 이상 소요)
* 충전식 결제, 정기 결제는 승인이 오래걸리며 최초 심사 시 (스타트업 기준) 승인 거부가 빈번한 편이에요.
* 두 세 곳을 연락해 본 후, 응대를 잘 해주고 승인이 빨리 나는 곳을 선택해 주시면 돼요.
* PG사 가입을 완료하고 결제 모듈을 구축하여야 해요. PG사 마다 결제 모듈 연동은 상이해요.

***

포트원 계정을 생성했다면 API키를 통해 오마이앱과 연동시켜 볼게요.

## API 연동하기

#### 1️⃣ API Keys 확인

\[포트원 관리자 페이지]에 접속 ➡︎ 연동 관리 ➡︎ 연동 정보 ➡︎ 식별코드 - API Keys

<figure><img src="/files/B0zYEsDW9GAKqTxKcFme" alt=""><figcaption></figcaption></figure>

#### 2️⃣ 관리자 웹에 API Key 추가

인터넷 새 창 ➡︎ 관리자 웹 ➡︎ 고급 설정 ➡︎ API 키 설정 ➡︎ 아임포트

(REST API Key를 API Key에 추가하고 REST API secret을 secret Key에 추가해 주세요.)

<figure><img src="/files/rhQfx6FdBl6QyuYY8DgW" alt=""><figcaption></figcaption></figure>

#### 3️⃣ 환경설정 > 결제 : 포트원 설정

관리자 웹 ➡︎ 환경 설정 ➡︎ 모바일 앱 설정 ➡︎ 결제 : 포트원 ➡︎ 포트원 키에 **"가맹점 식별코드"**&#xB97C; 넣어주세요.

(포트원 결제 대행사는 가입한 PG사로 넣어주세요.)

<figure><img src="/files/W0wKNzar7dd7YWytJO5W" alt=""><figcaption></figcaption></figure>

#### 4️⃣ API 테스트 추가

다음 이미지를 참고해서 테스트 결제를 추가해 주세요.

(채널 이름은 자유롭게 작성해 주세요. 각 PG사에 맞게 나머지 빈칸을 작성해 주세요.)

<figure><img src="/files/eJ9AxARuIbYNgNI4G9Vs" alt=""><figcaption></figcaption></figure>

#### ️5️⃣ 테스트

앱에서 정상적으로 테스트 결제가 진행하는지 확인해요.

24.07.12 Jihwan


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.ohmyapp.io/main/guide/faq/payment_api/1.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.