# 페이팔 설정

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

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

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

{% hint style="danger" %}
Paypal Express checkout 신규 신청 및 신규 연동이 불가합니다. 페이팔 연동을 원하는 경우, [페이팔 SPB(Smart Payment Buttons) 연동 방법](https://portone.gitbook.io/docs/ready/2.-pg/payment-gateway/paypal-spb)으로 진행 바랍니다.
{% endhint %}

## 인증결제

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

> * 페이팔 테스트 환경 구성을 위해서는 **포트원 관리자 페이지 설정**과 **페이팔 관리자페이지 설정**이 각각 적용되어야 합니다.
> * 페이팔은 별도의 계약없이 판매자 계정만 생성하면 바로 서비스 이용이 가능합니다.

**포트원 관리자 콘솔 설정**

[포트원 관리자 콘솔](https://admin.portone.io/)→ 시스템설정 → PG설정(**일반결제 및 정기결제**) → PG사 페이팔-Express Checkout 선택 → <mark style="color:red;">**테스트모드 \[ON]**</mark> → API 사용자 정보 입력 → \[전체 저장] 클릭

![](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FYDz3den8UwTZz9RSh2i0%2Fimage.png?alt=media\&token=688dca54-0870-4ada-912a-94ed15827780)

{% hint style="danger" %}
**Email 계정주소 설정시 주의사항**

자동완성된 Email 주소가 **실제 페이팔 계정 ID와 상이한 경우** <mark style="color:red;">**실 계정 ID 로 수정**</mark>하여 저장해야 합니다.
{% endhint %}

**페이팔 관리자 콘솔 설정**

<mark style="color:purple;">**판매자 Sandbox 계정 설정**</mark>

1. <https://developer.paypal.com/developer/accounts/> 로그인 > **SANDBOX** > **Accounts** > DEFAULT Business 계정의 \[**View/edit account**] 클릭

![Accounts 예](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FS5FFZcsDgQf4WiGExhPE%2Fimage.png?alt=media\&token=d4345576-7328-4179-8f41-8869854528d0)

**2. Account details 팝업창**

API Credentials 탭의 Username, Password, 및 Signature 값을 포트원 관리자 콘솔 페이팔 설정 항목에 아래와 같이 맵핑합니다.

* Username = API 사용자 이름
* Password = API 암호
* Signature = 서명

![API Credentials](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FWxFmLQAsW1lfTKXGp3ZR%2Fimage.png?alt=media\&token=5156f248-15b3-4afa-9423-f199b215423a)

<mark style="color:purple;">**구매자 Sandbox 계정 설정**</mark>

1. <https://developer.paypal.com/developer/accounts/> 로그인 > **SANDBOX** > **Accounts** > DEFAULT Personal 계정의 \[**View/edit account**] 클릭

![Accounts 예](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FEXQGeev3wWiDYl2f1E16%2Fimage.png?alt=media\&token=7cd45315-3e21-4b36-aed8-c76d229ca637)

**2. Account details 팝업창**

Profile 탭의 **Email ID** 및 **Password** 값을 페이팔 결제시 구매자 로그인 계정정보로 사용합니다.

![](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FqoqgnuGa25zVGdf4zXxT%2Fimage.png?alt=media\&token=feddd0dd-492d-4f13-97c1-5f061628b350)
{% endtab %}

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

[포트원 관리자 콘솔](https://admin.portone.io/)→ 시스템설정 → PG설정(**일반결제 및 정기결제**) → PG사 페이팔-Express Checkout 선택 → **테스트모드 \[OFF]** → API 사용자 정보 입력 → \[전체 저장] 클릭

![](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2F8dbpcNS1XijI4Yft2s0p%2Fimage.png?alt=media\&token=086f85e5-5723-4c32-b44f-6affbe96ed22)

> **각 항목별 실 운영 정보 값은 페이팔 관리자 페이지에서 아래 절차를 통해 확인합니다.**

1. <https://www.paypal.com/> 로그인 > 계정 클릭 > 계정 설정 클릭 > "계정 엑세스" 클릭 > "**API 엑세스**"의 업데이트 클릭

![](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FNxHAp1Npe8Q4qOORZoyc%2Fimage.png?alt=media\&token=383aa503-db53-45b5-9f6c-42197c58fa57)

**2) NVP/SOAP API 통합(클래식) 의 API 자격증명 관리 클릭**

\- 참고 : 휴대폰본인인증 절차 필요

![](https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2FCoHZbeBlrO8SthSTFHZE%2Fimage.png?alt=media\&token=39aac4a8-960d-4950-9b72-fafce24ee9b1)

**3) API 서명보기 "표시" 클릭**

* API 사용자 이름 \* API 비밀번호
* 서명
  {% endtab %}
  {% endtabs %}

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

* Business 계정이 Sandbox이면 구매자 계정도 Sandbox Accounts 목록에 존재하는 Personal 계정으로 결제(사용)해야 합니다.
* Sandbox Accounts 의 Country 가 "US"인 Personal 계정으로 테스트해야 합니다. **판매자와 구매자 계정 국가가 "한국"인 경우 페이팔 정책상 결제가 불가**하며, **판매자는 한국이고 구매자가 미국인 경우는 가능**합니다.
* 판매자와 구매자 계정 국가가 "한국"인 경우 페이팔 정책상 결제가 불가합니다. 판매자와 구매자 중 최소 한사람의 국가가 해외여야 합니다
* 포트원은 페이팔 정기결제를 지원하지 않습니다.
  {% endhint %}
