> 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/api-guides-en/back-office/payment-bo/payment-method-management.md).

# Payment Method Management

A service for managing payment methods, viewing payment history, and managing merchant information. It uses the account holder name verification MID API when verifying accounts.

***

## Key Features

* **Payment Method Management**
  * PG Company List Lookup: Looks up the list of PG companies registered in common code (OM030).
  * Payment Method Lookup by PG Company: Looks up the list of payment methods registered for each PG company.
  * Payment Method Registration/Modification: Newly registers or modifies payment methods for each PG company.
  * PG Company Usage Status Modification: Modifies the usage status of PG companies registered in common code (OM030).
* **Payment History Lookup**
  * Mileage Payment History Lookup: Looks up payments made using the mileage payment method.
  * Mileage Payment Refund Request: Requests a refund for mileage payment cases in refund-received status.
  * Cash Payment History Lookup: Looks up payments made using the cash payment method.
  * Credit Card Payment History Lookup: Looks up payments made using the credit card payment method.
* **Merchant Information Management**
  * Merchant List Lookup: Looks up the merchant list using information such as merchant number and usage status.
  * Merchant Detail Information Lookup: Looks up merchant detail information using the merchant number.
  * Merchant Registration: Registers a merchant using the PG company, MID, and more.
  * Merchant Duplicate Check: When registering a merchant, checks for duplicates using information such as the PG classification code and system classification code.
  * Merchant Information Modification: Modifies merchant information such as the MID and usage status.
* **Account Verification Management**
  * Looks up the account holder name verification MID API to proceed with account verification.

## Process Definition

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FreMbBvofY1BwdBkXTxoe%2F%E1%84%89%E1%85%AE%E1%84%83%E1%85%A1%E1%86%AB.png?alt=media&#x26;token=53051720-cbe2-4597-9d85-a490e7ac2d88" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### PG Company List Lookup

Looks up the list of PG companies.
{% endstep %}

{% step %}

### PG Company List Modification

Modifies the usage status information of PG companies.
{% endstep %}

{% step %}

### Payment Method List Lookup by PG Company

Looks up the list of payment methods by PG company.
{% endstep %}

{% step %}

### Payment Method Registration/Modification by PG Company

Registers new payment methods by PG company or modifies the connection status information.
{% endstep %}

{% step %}

### Mileage Payment Refund Request

Processes the refund completion for mileage payment cases with refund-received status.
{% endstep %}

{% step %}

### Mileage Payment History Lookup

Looks up payment history using the mileage payment method.
{% endstep %}

{% step %}

### Cash Payment History Lookup

Looks up payment history using the cash payment method.
{% endstep %}

{% step %}

### Credit Card Payment History Lookup

Looks up payment history using the credit card payment method.
{% endstep %}

{% step %}

### Merchant List Lookup

Looks up the merchant list.
{% endstep %}

{% step %}

### Merchant Information Lookup

Looks up merchant detail information.
{% endstep %}

{% step %}

### Merchant Duplicate Check

Looks up duplicate merchants using the entered PG classification code, other merchant classification code, and system classification code information.
{% endstep %}

{% step %}

### Merchant Registration

Registers a merchant using the PG company, MID, and more.
{% endstep %}

{% step %}

### Merchant Modification

Modifies merchant information such as the MID and usage status.
{% endstep %}
{% endstepper %}

## API Function List\_Payment Method Management

<table><thead><tr><th width="139">API</th><th width="364.22216796875">Description</th><th width="93.5555419921875">Server</th><th width="91.3333740234375">Method</th><th>Notes</th></tr></thead><tbody><tr><td>PG Company List Modification</td><td>You can modify the usage status of payment methods registered in common code (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">🔗View API ></a></td></tr><tr><td>Payment Method Registration/Modification by PG Company</td><td>You can newly register payment methods by PG company, or modify the connection status of previously registered payment methods.</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">🔗View API ></a></td></tr><tr><td>PG Company List Lookup</td><td>Looks up the PG company information registered in common code (OM030).</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">🔗View API ></a></td></tr><tr><td>Payment Method List Lookup by PG Company</td><td>Looks up the payment methods registered with the corresponding PG company.</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">🔗View API ></a></td></tr></tbody></table>

## API Function List\_Payment History Lookup

<table><thead><tr><th width="132.3333740234375">API</th><th width="309.666748046875">Description</th><th width="93.5555419921875">Server</th><th width="93.5555419921875">Method</th><th>Notes</th></tr></thead><tbody><tr><td>Mileage Payment Refund Request</td><td>Refunds mileage refund cases in refund-received status.</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">🔗View API ></a></td></tr><tr><td>Mileage Payment History Lookup</td><td>Looks up payment history made with the mileage payment method.</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">🔗View API ></a></td></tr><tr><td>Cash Payment History Lookup</td><td>Looks up payment history made with the cash payment method.</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">🔗View API ></a></td></tr><tr><td>Credit Card Payment History Lookup</td><td>Looks up payment history made with the credit card payment method.</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">🔗View API ></a></td></tr></tbody></table>

## API Function List\_Merchant Management

<table><thead><tr><th width="126.77783203125">API</th><th width="318.3333740234375">Description</th><th width="93.5555419921875">Server</th><th width="93.5556640625">Method</th><th>Notes</th></tr></thead><tbody><tr><td>Merchant Registration</td><td>Registers a merchant using the PG company, MID, and more.</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">🔗View API ></a></td></tr><tr><td>Merchant Modification</td><td>Modifies merchant information such as the MID and usage status.</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">🔗View API ></a></td></tr><tr><td>Merchant Duplicate Check</td><td>Looks up duplicate merchants using the entered PG classification code, other merchant classification code, and system classification code information.</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">🔗View API ></a></td></tr><tr><td>Merchant List Lookup</td><td>Looks up the merchant list.</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">🔗View API ></a></td></tr><tr><td>Merchant Information Lookup</td><td>Looks up merchant detail information.</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">🔗View API ></a></td></tr></tbody></table>

## API Function List\_Account Verification Management

<table><thead><tr><th width="104.5555419921875">API</th><th width="255.5556640625">Description</th><th width="95.6666259765625">Server</th><th width="90.4444580078125">Method</th><th></th></tr></thead><tbody><tr><td>Account Holder Name Verification MID Lookup</td><td>Looks up the account holder name verification MID used during account verification.</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">🔗View API ></a></td></tr></tbody></table>

## Glossary

<table><thead><tr><th width="84">Term</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>MID</td><td><p>Short for Merchant ID</p><ul><li>Used to distinguish the merchant or purpose when a payment occurs</li><li>Payment-related settings are typically configured based on the MID</li><li>For example, credit card payment may be attached to MID1 and virtual account payment to MID2. Or MID1 may be linked to PC payments and MID2 to mobile payments</li><li>It is also possible to configure and use a single integrated MID</li><li>Typically issued and used through a payment gateway (PG company or simple payment provider)</li></ul></td><td></td></tr></tbody></table>