[공지] [SDK] iOS v1.5.10 업데이트 내역 안내

PAYCO 로그인 개발자센터

개발 가이드

PAYCO 로그인 부가 기능(고급)

## 개인정보 제공 동의 철회
- 사용자의 개인정보 제공 동의를 철회하는 API 입니다.
- 서비스 탈퇴를 처리하는 경우 반드시 이 API를 호출해야 합니다.
- <a href=#individualInformationOfferAgreeRepeal>1. 개인정보 제공 동의 철회 API</a>

## 개인정보 추가 동의
- 사용자는 필수 항목을 제외한 선택 항목의 제공 동의를 하지 않을 수 있습니다.
- 개인정보 추가 동의 페이지 연동을 통해 사용자가 거부한 항목을 다시 요청할 수 있습니다.
- 다만, 사용자는 계속적으로 제공을 거부할 수 있기 때문에 선택 항목 제공을 거부하더라도 PAYCO 로그인 후 서비스를 이용할 수 있도록 구현해주시기 바랍니다.
- <a href=#issueOfferAgreementTicket>2. 개인정보 추가 동의 페이지 접근용 티켓 발급 API</a>
- <a href=#offerAgreement>3. 개인정보 추가 동의 페이지 연동</a>

---

# <a name="individualInformationOfferAgreeRepeal" id="individualInformationOfferAgreeRepeal"></a>1. 개인정보 제공 동의 철회 API

## 1.1 설명

- 토큰에 해당하는 사용자의 개인정보 제공 동의를 철회하는 API입니다.
- 개인정보 제공 동의 철회는 서비스에 대한 사용자의 탈퇴입니다. (철회 후, 동일 PAYCO 아이디로 서비스 재동의 가능)
- 서비스에서 자체적으로 서비스 탈퇴를 처리하는 경우 반드시 이 API를 호출해야 합니다.
- 파라미터는 JSON 타입으로 전달되어야 합니다.
- Request Header에 client_id와 access_token 정보가 포함되어야 합니다.

## 1.2 요청 URL

- URL : `https://apis-payco.krp.toastoven.net/payco/friends/remove_offer_agreement_v2.json`

## 1.3 프로토콜

- HTTPS

## 1.4 HTTP 메서드

- POST

## 1.5 파라미터

- Request Headers Parameters

| 파라미터   | 타입     |필수 여부 |설명               |
|----------|---------|---------|-----------------|
|client_id   |String |Y        |발급받은 CLIENT ID |
|access_token|String |Y        |access token      |

## 1.6 요청 예

- URL : `https://apis-payco.krp.toastoven.net/payco/friends/remove_offer_agreement_v2.json`
- Request Headers Parameters :

```
client_id : 3RDtTePsdfd8dgggPcD
access_token : AAAA1EPalGCz5FbclikH2G/Z3PHKn3aaaaaaaaaywr51hVXJE+c2JIyJY/6EbxvjY96zYkuJ1mLgN7jSrW81CHL6X+Pjk vdFWiUrbgGmbI2Bg0kAM0b7hWlngA5RSTRnrTaVfasdNh3Rd6cSfqqzV3cA0zTC2mltDgneZYQYV o1pR5hWuruW GFdYi16db//5bhW0k/Lqm 0HYOHqpKcl Bbbbbbbbbq69EHQ6d8FcW4u3hm6Y 0Y1xOWY 0U+mcKmS/jl+Y 78Hfkvt VqIyyWbdBHZIUkzlS5IXoV2Sx6Klt/io9m2Ol
```

## 1.7 응답

- JSON 타입의 응답이 리턴됩니다.

| 키 | 타입 | 설명 | 
| --- | --- | --- | 
| header | object | 공통 반환 값 | 
| data | object | 데이터 정보(null) |

- Header

| 키 | 타입 | 설명 | 
| --- | --- | --- | 
| isSuccessful | boolean | 성공 여부 (true : 성공, false : 실패) |
| resultCode | int | 결과 코드 |
| resultMessage | string | 결과 메세지 (SUCCESS : 성공, 그 외 메세지) |

## 1.8 응답 예

```
{
    "header": {
        "isSuccessful": true,
        "resultCode": 0,
        "resultMessage": "SUCCESS"
    },
    "data": null
}
```

---

# <a name="issueOfferAgreementTicket"></a>2. 개인정보 추가 동의 페이지 접근용 티켓 발급

## 2.1 설명

- 서비스에서 개인정보 제공 동의 페이지를 띄우기 위해 필요한 API입니다.
- 파라미터는 JSON 타입으로 전달되어야 합니다.
- Request Header에 client_id와 access_token 정보가 포함되어야 합니다.

## 2.2 요청URL

- URL : `https://apis-payco.krp.toastoven.net/payco/friends/issue_third_agreement_ticket_v2.json`

## 2.3 프로토콜

- HTTPS

## 2.4 HTTP 메서드

- POST

## 2.5 파라미터

- Request Headers Parameters

- Request Body Parameters(JSON)

| 파라미터   | 타입     |필수 여부 |설명               |
|----------|---------|---------|-----------------|
|redirect_uri   |String |Y        |개인정보 제공 동의 페이지 완료 후 이동할 URL |

## 2.6 요청 예

- URL : `https://apis-payco.krp.toastoven.net/payco/friends/issue_third_agreement_ticket_v2.json`
- Request Headers Parameters :

- Request Body(JSON) :

```
{
   "redirect_uri" : "https://payco.com"
}
```

## 2.7 응답

- JSON 타입의 응답이 리턴됩니다.

| 키 | 타입 | 설명 | 
| --- | --- | --- | 
| header | object | 공통 반환 값 | 
| data | object | 데이터 정보 |

- Header

- Data

| 키 | 타입 | 설명 | 
| --- | --- | --- | 
| ticket | string | 개인정보 제공 동의 페이지 접근용 티켓 |

## 2.8 응답 예

```
{
    "header": {
        "isSuccessful": true,
        "resultCode": 0,
        "resultMessage": "SUCCESS"
    },
    "data": {
        "ticket": "a87f9e61b85d4ef4968dbd37ddf74d5f"
    }
}
```
---

# <a name="offerAgreement"></a>3. 개인정보 추가 동의 페이지 연동

## 3.1 설명
- 사용자가 제공 동의하지 않은 개인정보 수집 항목에 대해 추가로 동의 요청할 수 있습니다.
- 사용자는 필수 항목을 제외한 선택 항목의 제공 동의를 하지 않을 수 있습니다.
- 다만, 사용자는 계속적으로 제공을 거부할 수 있기 때문에 선택 항목 제공을 거부하더라도 PAYCO 로그인 후 서비스를 이용할 수 있도록 구현해주시기 바랍니다.
- 페이지를 호출하는 URL이므로 사용자의 브라우저 등에서 요청되어야 합니다.
- `2. 개인정보 제공 동의 페이지 접근용 티켓 발급`을 통해 티켓을 받급한 상태여야 합니다.

## 3.2 요청 URL

- URL : `https://id.payco.com/v2/third-agreement/view`

## 3.3 프로토콜

- HTTPS

## 3.4 HTTP 메서드

- GET

## 3.5 파라미터

| 파라미터         | 타입     |필수 여부 |설명               |
|----------------|---------|---------|-----------------|
|ticket   |String |Y        |`2. 개인정보 제공 동의 페이지 접근용 티켓 발급`을 통해 발급한 티켓|

## 3.6 요청 예
```json
https://id.payco.com/v2/third-agreement/view?ticket=a87f9e61b85d4ef4968dbd37ddf74d5f
```

## 3.7 응답

- 응답이 완료되면 `2. 개인정보 제공 동의 페이지 접근용 티켓 발급`에서 설정한 redirect_uri로 이동합니다.

맨위로 이동

PAYCO 로그인 개발자센터

본문영역

개발 가이드

PAYCO 로그인 부가 기능(고급)