Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

페이코 popup 파라미터 설명 추가 #505

Merged
merged 3 commits into from
Jun 12, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 52 additions & 1 deletion src/content/docs/ko/pg/payment-gateway/eximbay.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ import Hint from "~/components/Hint.astro";
merchant_uid: "order_no_0001", // 상점에서 관리하는 주문 번호
name: "주문명:결제테스트",
amount: 14.2,
currency: "USD", // 기본값: USD(원화 KRW는 페이팔 정책으로 인해 지원하지 않음)
currency: "USD", // 기본값: USD
buyer_email: "[email protected]",
buyer_name: "구매자이름",
buyer_tel: "010-1234-5678",
Expand Down Expand Up @@ -162,3 +162,54 @@ import Hint from "~/components/Hint.astro";

7. 10분 후 결제상태가 `status: "paid"`로 바뀌는지 확인 (이 때 입금에 대한 웹훅 발송됨)
</Details>

## 3. 기타 파라미터

<Tabs>
<Tab title="국내 결제창 호출">
엑심베이**국내 결제창**을 사용하기 위해서는 아래와 같은 방법으로 파라미터 설정이 필요합니다.

```json
{
"bypass": {
"issuercountry": "KR"
}
}
```

<Hint style="success">
**국내 결제창 카드 별 승인 통화**

**해외카드**

- VISA/MAster/JCB : KRW 승인 (자국통화승인 서비스 가능)
- AMEX/UnionPay : USD 승인 (자국통화승인 서비스 불가)

**국내카드(국내에서 발행 된 (8개) 카드사 모두 이용 가능)**

- 결제(승인)/정산 통화 : KRW만 지원
</Hint>

**국내 결제창을 호출하는 경우**

```ts
IMP.request_pay({
pg: "eximbay.{상점 ID}",
pay_method: "card",
merchant_uid: "order_no_0001",
name: "주문명:결제테스트",
amount: 14.2,
currency: "KRW",
buyer_email: "[email protected]",
buyer_name: "구매자이름",
buyer_tel: "010-1234-5678",
buyer_addr: "서울특별시 강남구 삼성동",
buyer_postcode: "123-456",
popup: false,
bypass: {
issuercountry: "KR",
},
});
```
</Tab>
</Tabs>
13 changes: 13 additions & 0 deletions src/content/docs/ko/pg/simple/payco.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,13 @@ import Hint from "~/components/Hint.astro";

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

**`popup`** <mark style="color:green;">**boolean**</mark>

페이코의 경우 모바일 환경에서 기본으로 iframe 방식으로 결제창이 호출됩니다.
팝업 방식으로 결제창 호출을 원하시는 경우 `popup : true`로 설정해 주세요.

**WebView 등 팝업이 차단되는 환경**에서는 `popup : false`로 설정하신 후 호출하시길 권장드립니다.

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

**결제수단 구분코드**
Expand Down Expand Up @@ -120,6 +127,12 @@ import Hint from "~/components/Hint.astro";

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

**`popup`** <mark style="color:green;">**boolean**</mark>

페이코의 경우 모바일에서 기본으로 iframe 방식으로 결제창이 호출됩니다. `popup : true`로 설정하시면 결제창이 팝업창으로 뜨게 됩니다.

**WebView 등 팝업이 차단되는 환경**에서는 `popup : false`로 설정하는 것을 권장합니다.

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

**카드 빌링키**
Expand Down