> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/back-office/payment-bo/undefined.md).

# 결제수단 관리

결제수단의 관리, 결제내역 조회 및 가맹점 정보를 관리하는 서비스로, 계좌 인증 시 계좌성명 인증용 MID API를 활용합니다.

***

## 주요 기능

* **결제수단 관리**
  * PG사 목록 조회: 공통코드(OM030)에 등록된 PG사 목록을 조회합니다.
  * PG사별 결제수단 조회: 각 PG사별로 등록된 결제수단 목록을 조회합니다.
  * 결제수단 등록/수정: PG사별 결제수단을 신규로 등록하거나 수정합니다.
  * PG사 사용여부 수정: 공통코드(OM030)에 등록된 PG사의 사용 여부를 수정합니다.
* **결제내역 조회**
  * 마일리지 결제내역 조회: 마일리지 결제수단을 사용한 결제 건을 조회합니다.
  * 마일리지 결제 환불 요청: 환불 접수 상태의 마일리지 사용 건을 환불 요청합니다.
  * 현금 결제내역 조회: 현금 결제수단을 사용한 결제 건을 조회합니다.
  * 신용카드 결제내역 조회: 신용카드 결제수단을 사용한 결제 건을 조회합니다.
* **가맹점 정보 관리**
  * 가맹점 목록 조회: 가맹점번호, 사용여부 등의 정보를 사용하여 가맹점 목록을 조회합니다.
  * 가맹점 상세 정보 조회: 가맹점번호를 사용하여 가맹점 상세 정보를 조회합니다.
  * 가맹점 등록: PG사, MID 등을 사용하여 가맹점을 등록합니다.
  * 가맹점 중복 확인: 가맹점 등록 시 PG구분코드, 시스템구분코드 등의 정보를 사용하여 중복 확인을 진행합니다.
  * 가맹점 정보 수정: 가맹점의 MID, 사용 여부 등을 사용하여 정보를 수정합니다.
* **계좌 인증 관리**
  * 계좌 인증 시 계좌성명 인증용 MID API를 조회하여 계좌 인증을 진행합니다.

## 프로세스 정의

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

{% stepper %}
{% step %}

### PG 사 목록 조회

PG사 목록을 조회합니다.
{% endstep %}

{% step %}

### PG 사 목록 수정

PG사의 사용여부 정보를 수정합니다.
{% endstep %}

{% step %}

### PG 사 별 결제수단 목록 조회

PG사 별 결제수단 목록을 조회합니다.
{% endstep %}

{% step %}

### PG 사 별 결제수단 등록/수정

PG사 별 결제수단의 신규 등록이나 연결여부 정보를 수정합니다.
{% endstep %}

{% step %}

### 마일리지 결제 환불 요청

환불접수 건의 마일리지 결제 건을 환불 완료 처리합니다.
{% endstep %}

{% step %}

### 마일리지 결제 내역 조회

마일리지 결제수단을 사용한 결제내역을 조회합니다.
{% endstep %}

{% step %}

### 현금 결제 내역 조회

현금 결제수단을 사용한 결제내역을 조회합니다.
{% endstep %}

{% step %}

### 신용카드 결제 내역 조회

신용카드 결제수단을 사용한 결제내역을 조회합니다.
{% endstep %}

{% step %}

### 가맹점 목록 조회

가맹점 목록을 조회합니다.
{% endstep %}

{% step %}

### 가맹점 정보 조회

가맹점 상세 정보를 조회합니다.
{% endstep %}

{% step %}

### 가맹점 중복 확인

입력한 PG구분코드, 가맹점기타구분코드, 시스템구분코드의 정보로 중복된 가맹점을 조회합니다.
{% endstep %}

{% step %}

### 가맹점 등록

PG사, MID 등을 사용하여 가맹점을 등록합니다.
{% endstep %}

{% step %}

### 가맹점 수정

가맹점의 MID, 사용여부 등 정보를 수정합니다.
{% endstep %}
{% endstepper %}

## API 기능 목록\_결제수단 관리

<table><thead><tr><th width="139">API</th><th width="364.22216796875">설명</th><th width="93.5555419921875">Server</th><th width="91.3333740234375">메소드</th><th>비고</th></tr></thead><tbody><tr><td>PG사 목록 수정</td><td>공통코드(OM030)에 등록되어있는 결제수단의 사용여부를 수정할 수 있습니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=payment&#x26;depth=%EA%B2%B0%EC%A0%9C%EC%88%98%EB%8B%A8%20%EA%B4%80%EB%A6%AC&#x26;path=savePgList">🔗API 확인하기 ></a></td></tr><tr><td>PG사 별 결제수단 등록/수정</td><td>PG사 별 결제수단을 신규로 등록하거나, 기존에 등록되어있는 결제수단의 연결여부를 수정할 수 있습니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=payment&#x26;depth=%EA%B2%B0%EC%A0%9C%EC%88%98%EB%8B%A8%20%EA%B4%80%EB%A6%AC&#x26;path=savePaymentMethodList">🔗API 확인하기 ></a></td></tr><tr><td>PG사 목록 조회</td><td>공통코드(OM030)에 등록되어있는 PG사 정보를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=payment&#x26;depth=%EA%B2%B0%EC%A0%9C%EC%88%98%EB%8B%A8%20%EA%B4%80%EB%A6%AC&#x26;path=getPgList">🔗API 확인하기 ></a></td></tr><tr><td>PG사 별 결제수단 목록 조회</td><td>해당 PG 사에 등록되어 있는 결제수단을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=payment&#x26;depth=%EA%B2%B0%EC%A0%9C%EC%88%98%EB%8B%A8%20%EA%B4%80%EB%A6%AC&#x26;path=getPaymentMethodListByPg">🔗API 확인하기 ></a></td></tr></tbody></table>

## API 기능 목록\_결제내역 조회

<table><thead><tr><th width="132.3333740234375">API</th><th width="309.666748046875">설명</th><th width="93.5555419921875">Server</th><th width="93.5555419921875">메소드</th><th>비고</th></tr></thead><tbody><tr><td>마일리지 결제 환불 요청</td><td>환불접수 상태의 마일리지 환불 건들을 환불합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=payment&#x26;depth=%EA%B2%B0%EC%A0%9C%EB%82%B4%EC%97%AD%20%EC%A1%B0%ED%9A%8C&#x26;path=refundMileagePayment">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 결제내역 조회</td><td>마일리지 결제수단으로 결제한 내역을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=payment&#x26;depth=%EA%B2%B0%EC%A0%9C%EB%82%B4%EC%97%AD%20%EC%A1%B0%ED%9A%8C&#x26;path=getMileagePaymentList">🔗API 확인하기 ></a></td></tr><tr><td>현금 결제내역 조회</td><td>현금 결제수단으로 결제한 내역을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=payment&#x26;depth=%EA%B2%B0%EC%A0%9C%EB%82%B4%EC%97%AD%20%EC%A1%B0%ED%9A%8C&#x26;path=getCashPaymentList">🔗API 확인하기 ></a></td></tr><tr><td>신용카드 결제내역 조회</td><td>신용카드 결제수단으로 결제한 내역을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=payment&#x26;depth=%EA%B2%B0%EC%A0%9C%EB%82%B4%EC%97%AD%20%EC%A1%B0%ED%9A%8C&#x26;path=getCardPaymentList">🔗API 확인하기 ></a></td></tr></tbody></table>

## API 기능 목록\_가맹점 관리

<table><thead><tr><th width="126.77783203125">API</th><th width="318.3333740234375">설명</th><th width="93.5555419921875">Server</th><th width="93.5556640625">메소드</th><th>비고</th></tr></thead><tbody><tr><td>가맹점 등록</td><td>PG사, MID 등을 사용하여 가맹점을 등록합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=payment&#x26;depth=%EA%B0%80%EB%A7%B9%EC%A0%90%20%EA%B4%80%EB%A6%AC&#x26;path=registerFranchisee">🔗API 확인하기 ></a></td></tr><tr><td>가맹점 수정</td><td>가맹점의 MID, 사용여부 등 정보를 수정합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=payment&#x26;depth=%EA%B0%80%EB%A7%B9%EC%A0%90%20%EA%B4%80%EB%A6%AC&#x26;path=registerFranchisee">🔗API 확인하기 ></a></td></tr><tr><td>가맹점 중복 확인</td><td>입력한 PG구분코드, 가맹점기타구분코드, 시스템구분코드의 정보로 중복된 가맹점을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=payment&#x26;depth=%EA%B0%80%EB%A7%B9%EC%A0%90%20%EA%B4%80%EB%A6%AC&#x26;path=getMersNoCheck">🔗API 확인하기 ></a></td></tr><tr><td>가맹점 목록 조회</td><td>가맹점 목록을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=payment&#x26;depth=%EA%B0%80%EB%A7%B9%EC%A0%90%20%EA%B4%80%EB%A6%AC&#x26;path=getFranchiseeList">🔗API 확인하기 ></a></td></tr><tr><td>가맹점 정보 조회</td><td>가맹점 상세 정보를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=payment&#x26;depth=%EA%B0%80%EB%A7%B9%EC%A0%90%20%EA%B4%80%EB%A6%AC&#x26;path=getFranchiseeList">🔗API 확인하기 ></a></td></tr></tbody></table>

## API 기능 목록\_계좌인증 관리

<table><thead><tr><th width="104.5555419921875">API</th><th width="255.5556640625">설명</th><th width="95.6666259765625">Server</th><th width="90.4444580078125">메소드</th><th></th></tr></thead><tbody><tr><td>계좌성명 인증용 MID 조회</td><td>계좌인증 시 계좌성명 인증용 MID 를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=payment&#x26;depth=%EA%B3%84%EC%A2%8C%EC%9D%B8%EC%A6%9D%20%EA%B4%80%EB%A6%AC&#x26;path=getAcoountCertiMid">🔗API 확인하기 ></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="84">명칭</th><th>설명</th><th data-hidden></th></tr></thead><tbody><tr><td>MID</td><td><p>Merchant ID의 준말</p><ul><li>결제를 일으킬 때 가맹점 또는 용도를 구분하기 위해 활용</li><li>결제 관련된 설정은 통상 MID 기준으로 셋팅 함</li><li>예를 들면 MID1 에는 신용카드를, MID2에는 가상계좌 결제를 붙이는 식으로 구분함. 또는 MID1은 PC, MID2에는 모바일결제를 연동하여 구분 할 수도 있음</li><li>하나의 MID에 통합으로 셋팅하여 사용하는 것도 가능함</li><li>통상 결제대행사 (PG사 또는 간편결제사)를 통해 발급 받아 활용함</li></ul></td><td></td></tr></tbody></table>