---
description: 엑심베이 결제 연동 방법을 안내합니다.
---

# 엑심베이

{% hint style="warning" %}
**Deprecated**

이 문서는 더 이상 관리되지 않습니다.

[PortOne 개발자센터](https://developers.portone.io/)를 이용해주세요.
{% endhint %}

### 1. 엑심베이 PG 설정하기

[**엑심베이 설정**](../../ready/2.-pg/payment-gateway/exim) 페이지의 내용을 참고하여 PG 설정을 진행합니다.

![](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2Fgit-blob-422fe6d51c825405103fa2799086c02f9f276c65%2F%EC%8A%A4%ED%81%AC%EB%A6%B0%EC%83%B7%202022-06-03%20%EC%98%A4%ED%9B%84%203.34.40.png?alt=media)

### 2.결제 요청하기

[JavaScript SDK](../../sdk/javascript-sdk-old) IMP.**request\_pay**(param, callback)을 호출하여 엑심베이 결제창을 호출할 수 있습니다. **결제결과**는 **PC / 모바일** 모두 <mark style="color:red;">**callback**</mark> 으로 전달됩니다.

{% tabs %}
{% tab title="인증결제창 요청" %}
{% code title="Javascript SDK" %}
```javascript
IMP.request_pay({
    pg : 'eximbay.{상점 ID}',
    pay_method : 'card',
    merchant_uid: "order_no_0001", // 상점에서 관리하는 주문 번호
    name : '주문명:결제테스트',
    amount : 14.20,
    currency : 'USD', // 기본값: USD(원화 KRW는 페이팔 정책으로 인해 지원하지 않음)
    buyer_email : 'test@portone.io',
    buyer_name : '구매자이름',
    buyer_tel : '010-1234-5678',
    buyer_addr : '서울특별시 강남구 삼성동',
    buyer_postcode : '123-456',
    popup:false // 팝업창 활성 비활성화 컨트롤 
}, function(rsp) { // callback 로직
	//* ...중략... *//
});
```
{% endcode %}

**주요 파라미터 설명**

**`pg` \***<mark style="color:green;">**string**</mark>

**PG사 구분코드**

**`eximbay`** 로 지정하면 됩니다.

**`pay_method`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

**결제수단 구분코드**

* 신용카드: card
* 위챗 : wechat
* 알리페이 : alipay
* 해외카드 : card
* 유니온페이 : unionpay
* 텐페이 : tenpay
* 일본 편의점결제(eContext) : econtext

**`merchant_uid`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

**`주문번호`**

매번 고유하게 채번되어야 합니다.

**`buyer_tel`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**`string`**</mark>

**`주문자 연락처`**

**`amount`** <mark style="color:red;">**\***</mark> <mark style="color:purple;">**`integer`**</mark>

**결제금액**

<mark style="color:green;">**string**</mark> 이 아닌점에 유의하세요

**`currency`** <mark style="color:green;">**`string`**</mark>

**결제통화코드**

* KRW
* USD
* EUR
* GBP
* JPY
* THB
* SGD
* RUB
* HKD
* CAD
* AUD

**`language`** <mark style="color:green;">**`string`**</mark>

* 한국어 : ko
* 영어 : en
* 중국어 : zh
* 일본어 : jp
{% endtab %}
{% endtabs %}

{% hint style="warning" %}
**참고사항**

포트원은 엑심베이 정기결제를 지원하지 않습니다.
{% endhint %}

<details>

<summary>편의점 결제 테스트 방법</summary>

**편의점결제 동작 방식**

한국의 가상계좌와 같이 결제창 내에서는 등록을 한 다음에 고객에게 이메일 / 문자로 전달되는 화면을 편의점 카운터에서 지불하며 처리합니다.

* 포트원 내부에서는 pay\_method : vbank 로 기록됨
* Econtext 등록이 완료되었다는 콜백함수 및 웹훅 전송 (status : ready 상태 / vbank\_num 은 unknown 으로 고정)
* Econtext 로부터 입금확인이 되면 포트원에서 엑심베이로부터 응답을 받아 status : paid 로 변경 후 결제완료처리에 대한 웹훅 전송

**편의점결제 테스트 진행순서**

가상계좌와 같이 실제 고객이 입금한 결과를 테스트해야 하므로 아래와 같이 입금완료됨을 임의적으로 통지받아보실 수 있습니다\*\*.\*\*

1.엑심베이 테스트모드 ON상태에서 1번과 같이 결제창 진행

2\. 콜백 응답 중 pg\_tid 값을 별도로 메모 (포트원 관리자콘솔 PG사승인번호 컬럼에서 확인 가능) 3. [http://test.econ.ne.jp/site/tuchi\_2/tuchi\_menu\_2.html](http://test.econ.ne.jp/site/tuchi_2/tuchi_menu_2.html) 로 이동 후 계정 로그인

(아이디 : ectest / 비번 : #eg0810# ) 4. ShopID : 361301, orderID : 2번에서 확보한 PG사승인번호 입력 5. 하단에 있는 **登録** 버튼 클릭 6. 다음 페이지에서 한 번 더 **登録** 클릭 7. 10분 후 결제상태가 status : **paid** 로 바뀌는지 확인 ( 이 때 입금에 대한 웹훅 발송됨 )

</details>
