# 다날 설정

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

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

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

## 인증**결제**

{% tabs %}
{% tab title="테스트 결제" %}
**테스트 환경 구성방법**

1. [포트원 관리자 콘솔](https://admin.portone.io/)→ **결제 연동** -> **테스트 연동 관리** -> **다날** -> <mark style="color:red;">**다날**</mark> 선택 -> **추가**
2. 자동으로 기재되는 CPID 정보 확인 후 **저장** \\

![포트원 관리자 콘솔→ 결제 연동 -> 테스트 연동 관리 -> 다날 -> 다날 선택 -> 추가](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2Ftoq4csAUPoNcMfLypb8j%2Fimage.png?alt=media\&token=9fe6f80c-6001-4027-b9c8-c5fb92abf4b7)

![자동으로 기재되는 CPID 정보 확인 후 저장](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FYMbWhhJAYOIwGFgfNZ2x%2Fimage.png?alt=media\&token=ac3a3d5e-c82e-40db-81c6-858ae28be0ae)
{% endtab %}

{% tab title="실 결제" %}
**실 환경 구성방법**

1. [포트원 관리자 콘솔](https://admin.portone.io/)→ **결제 연동 -> 실 연동 관리 선택**
2. **다날 ->&#x20;**<mark style="color:red;">**다날**</mark>**&#x20;선택 -> 추가**
3. 카드사 심사 완료 후 다날에서 발급받은 실상점 정보 기재 후 저장

![포트원 관리자 콘솔→ 결제 연동 -> 실 연동 관리 선택](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2F9tob4eMVGV1XLFptmBm8%2Fimage.png?alt=media\&token=5c1bb278-eaf5-4376-a8b6-830b3db0c997)

![다날 -> 다날 선택 -> 추가](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2Fslp9mKCxYbaE05h1SpM1%2Fimage.png?alt=media\&token=f634f1c4-8fa3-4139-b597-bd33b4bd631f)

![카드사 심사 완료 후 다날에서 발급받은 실상점 정보 기재 후 저장](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FYhRgU4Lam3avMdMdoy4h%2Fimage.png?alt=media\&token=cc60a0dc-11ce-469a-a31a-d86648734542)
{% endtab %}
{% endtabs %}

## 비 인증 결제

{% tabs %}
{% tab title="결제창 방식" %}
**테스트 환경 구성방법**

1. [포트원 관리자 콘솔](https://admin.portone.io/)→ **결제 연동** -> **테스트 연동 관리** -> **다날** -> <mark style="color:red;">**다날**</mark> 선택 -> **추가**
2. 자동으로 기재되는 CPID 정보 확인 후 **저장** \\

![포트원 관리자 콘솔→ 결제 연동 -> 테스트 연동 관리 -> 다날 -> 다날 선택 -> 추가](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2Ftoq4csAUPoNcMfLypb8j%2Fimage.png?alt=media\&token=9fe6f80c-6001-4027-b9c8-c5fb92abf4b7)

![자동으로 기재되는 CPID 정보 확인 후 저장](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FGpQNGWPttyGlWpg56ett%2Fimage.png?alt=media\&token=cfca348a-df4f-4cb9-b6d7-133217bafd1d)

**실 환경 구성방법**

1. [포트원 관리자 콘솔](https://admin.portone.io/)→ **결제 연동 -> 실 연동 관리 선택**
2. **다날 ->&#x20;**<mark style="color:red;">**다날**</mark>**&#x20;선택 -> 추가**
3. 카드사 심사 완료 후 다날에서 발급받은 실상점 정보 기재 후 저장

![포트원 관리자 콘솔→ 결제 연동 -> 실 연동 관리 선택](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2F9tob4eMVGV1XLFptmBm8%2Fimage.png?alt=media\&token=5c1bb278-eaf5-4376-a8b6-830b3db0c997)

![다날 -> 다날 선택 -> 추가](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FdnXqAXpa0dFLv1bW5FOg%2Fimage.png?alt=media\&token=c1266fbb-2469-4150-997d-d0cdd77f1574)

![카드사 심사 완료 후 다날에서 발급받은 실상점 정보 기재 후 저장](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FdhMEMfH4hkISGYGKzQQZ%2Fimage.png?alt=media\&token=a083b338-740d-44bd-a82f-ba12e0bff8de)
{% endtab %}

{% tab title="API 방식" %}
**다날은&#x20;**<mark style="color:red;">**API**</mark>**&#x20;를 통한 비인증 결제를 지원하지 않습니다.** :cry:
{% endtab %}
{% endtabs %}

## 휴대폰 소액결제

{% tabs %}
{% tab title="테스트 환경" %}
**테스트 환경 구성방법**

* [포트원 관리자 콘솔](https://admin.portone.io/)→ **결제 연동** -> **테스트 연동 관리** -> **다날** -> <mark style="color:red;">**다날**</mark> <mark style="color:red;">**휴대폰결제**</mark> 선택 -> **추가**
* 자동으로 기재되는 CPID 정보 확인 후 **저장**

{% hint style="info" %}
**다날 휴대폰결제 테스트용 CPID : A010002002**
{% endhint %}

![포트원 관리자 콘솔→ 결제 연동 -> 테스트 연동 관리 -> 다날 -> 다날 휴대폰결제 선택 -> 추가](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2F0rbpHgMiZaIP0eQ2dHgw%2Fimage.png?alt=media\&token=e9b0a062-34ee-43fa-9562-45450d20e4b2)

![자동으로 기재되는 CPID 정보 확인 후 저장](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FLWCJBIH9lqbFxdWpcvDd%2Fimage.png?alt=media\&token=80939316-813d-4e7a-b64b-742764e7ec67)
{% endtab %}

{% tab title="실 환경" %}
**실 환경 구성방법**

1. [포트원 관리자 콘솔](https://admin.portone.io/)→ **결제 연동 -> 실 연동 관리 선택**
2. **다날** -> <mark style="color:red;">**다날**</mark> <mark style="color:red;">**휴대폰결제**</mark> 선택 -> **추가**
3. 카드사 심사 완료 후 다날에서 발급받은 실상점 정보로 기재후 저장

![포트원 관리자 콘솔→ 결제 연동 -> 실 연동 관리 선택](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FhGXwzw5iXHdaBomxIoZH%2Fimage.png?alt=media\&token=177b6acf-1216-42cb-b7a0-f49464dea12b)

![다날 -> 다날 휴대폰결제 선택 -> 추가](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FAHADPFWinwkpA0I1LSmn%2Fimage.png?alt=media\&token=f3c0f874-e04c-4329-92f0-b20a2e865b9f)

![카드사 심사 완료 후 다날에서 발급받은 실상점 정보로 기재후 저장](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FhoiyPafYXvEEEBKYN9lc%2Fimage.png?alt=media\&token=8d9eaba6-fe42-42d4-a8be-a7562e2b47e9)
{% endtab %}
{% endtabs %}

## SMS 본인인증

{% tabs %}
{% tab title="테스트 환경" %}
**테스트 환경 구성방법**

* [포트원 관리자 콘솔](https://admin.portone.io/)→ **결제 연동** -> **테스트 연동 관리** -> **다날** -> <mark style="color:red;">**다날**</mark> <mark style="color:red;">**SMS 본인인증**</mark> 선택 -> **추가**
* 다날 계약 후 발급받은 CPID 정보를 기재 후 **저장**

{% hint style="warning" %}
**다날 SMS 본인인증**

휴대폰 SMS 본인인증은 테스트는 별도의 테스트 전용 CPID 정보를 제공하지 않습니다.

테스트 진행을 위해서는 다날 계약이후 발급받은 정보로만 가능합니다.
{% endhint %}

![포트원 관리자 콘솔→ 결제 연동 -> 테스트 연동 관리 -> 다날 -> 다날 SMS 본인인증 선택 -> 추가](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FaeES9Cea4JBtJhwHEpSt%2Fimage.png?alt=media\&token=de7d6c6d-5b1a-43ca-a113-ff286b09c816)

![다날 계약 후 발급받은 CPID 정보를 기재 후 저장](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FbGEBW1YJKUC4jGwUbJPO%2Fimage.png?alt=media\&token=ff07ef5f-6327-4f65-9331-ff81ed43e9a1)
{% endtab %}

{% tab title="실 환경" %}
**실 환경 구성방법**

1. [포트원 관리자 콘솔](https://admin.portone.io/)→ **결제 연동 -> 실 연동 관리 선택**
2. **다날** -> <mark style="color:red;">**다날**</mark> <mark style="color:red;">**휴대폰결제**</mark> 선택 -> **추가**
3. 카드사 심사 완료 후 다날에서 발급받은 실상점 정보로 기재후 저장

![포트원 관리자 콘솔→ 결제 연동 -> 실 연동 관리 선택](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FhGXwzw5iXHdaBomxIoZH%2Fimage.png?alt=media\&token=177b6acf-1216-42cb-b7a0-f49464dea12b)

![다날 -> 다날 휴대폰결제 선택 -> 추가](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2Fgit-blob-8e51fb5c66fac28d9d5d958ada4e5f39c68182a5%2Fimage%20\(25\)%20\(1\)%20\(2\).png?alt=media)

![카드사 심사 완료 후 다날에서 발급받은 실상점 정보로 기재후 저장](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FhoiyPafYXvEEEBKYN9lc%2Fimage.png?alt=media\&token=8d9eaba6-fe42-42d4-a8be-a7562e2b47e9)
{% endtab %}
{% endtabs %}

{% hint style="warning" %}
**특이사항**

* 다날은 하나의 상점ID(CPID)에 인증/비 인증 결제 셋팅이 가능합니다.
* 테스트 모드의 경우 실제로 결제승인이 이루어지지만, PG사에서 일괄적으로 매일 자정이전 자동 취소가 이루어집니다.
* 다날 정책상 계좌이체/가상계좌는 테스트 결제가 제공되지 않습니다. 계약 후 실제 상점아이디로 테스트를 해야 합니다
* SMS 본인인증은 통신사 정책으로 인하여 테스트 모드 이용이 불가합니다. (실 계약 후 이용가능)
* 테스트 모드에서 부분취소 테스트는 불가합니다.
  {% endhint %}


---

# Agent Instructions: 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:

```
GET https://portone.gitbook.io/docs/ready/2.-pg/payment-gateway/undefined.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
