{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"6136315c-f570-49c1-86c3-ab125a3917b1","name":"Pongift API","description":"## 폰기프트 API\n\n파트너센터 이용 방법에 대해서는 다음 매뉴얼을 참고해주세요.\n\n[파트너센터 이용매뉴얼](https://bold-antlion-a43.notion.site/1abc3e76a77f4195b1057c98e7adcd9f)\n\n## 변경 이력\n\n| **버전** | **날짜** | 내용 |\n| --- | --- | --- |\n| 1.1 | 2026-03-06 | 서비스, 사용처, 상품 관리 기능 추가  <br>상품권 조회기능 변경 |\n| 1.0 | 2025-07 | 상품권 사용처리 기능 |\n\n# **개요**\n\n## 1\\. API 신청 프로세스\n\n1\\. 폰기프트 파트너센터에서 회원가입 후 신청할 수 있습니다.\n\n| **운영환경** | **개발환경** |\n| --- | --- |\n| [https://partners.pongift.com](https://partners.pongift.com) | [https://partners.pongift.net](https://partners.pongift.net) |\n\n2\\. 폰기프트 API 신청 양식 작성 후 [pongift_api@platfos.com](https://mailto:pongift_api@platfos.com)으로 메일 발송  \n(폰기프트 API 사용신청서 : 담당자 별도 전달)\n\n3\\. 플랫포스 담당자가 신청 내역 확인 후 API Key (ClientID + ClientSecret) 발급\n\n- Key 발급은 신청에 문제가 없으면 N 영업일 이내에 발급됩니다.\n    \n- 추가검토나 보완이 필요한 사항은 담당자가 연락 드릴 예정입니다.\n    \n\n## **2\\. 개발/연동 프로세스**\n\n1. 개발환경 API이용 세팅\n    \n    1. 파트너센터에서 계정 등록하고 (사업자/서비스 등록) 승인\n        \n    2. 채널 생성 (상세 조건 협의를 통해 별도 진행)\n        \n    3. 개발환경 API Key 세팅 및 안내\n        \n2. API 문서를 참고하여 개발 진행 (개발환경 제공)\n    \n    1. 인증토큰 발급\n        \n    2. (필요 시) 서비스/사용처 추가 등록\n        \n    3. 상품 등록/수정\n        \n        1. 상품 카테고리 참조\n            \n    4. 상품 채널 등록/수정\n        \n        1. 채널 목록 참조\n            \n        2. 상품 채널 카테고리 참조\n            \n        3. (지마켓의 경우) 브랜드 카테고리 참조\n            \n    5. 주문 생성 및 취소\n        \n    6. 상품권 조회 및 사용/취소\n        \n3. 최종 연동 테스트\n    \n\n## **3\\. 기타사항**\n\n### **1) 테스트 상품 데이터 생성 시 고려 사항**\n\n- 상품 테스트 기간 사전 협의\n    \n    - 개발 환경 테스트 기간에 대한 사전 협의가 되어야 유통 채널에 상품 등록가능.\n        \n    - 운영 서버 연동 최초 개발 진행 시, 개발환경에서 유통 채널에 상품 연동 기능 지원\n        \n    - 개발 기간 종료 이후는 채널 연동 중단 (운영환경에서 테스트 하거나, 다시 개발 요청 필요)\n        \n- 테스트 상품 구매 방지\n    \n    - 유통채널 연동 시, 개발 서버에서 등록된 상품도 공개되며 실제 구매도 가능합니다.\n        \n    - 테스트 상품이므로 구매 하면 안된다는 내용 명시.  \n        (상품명 및 설명에 “\\[TEST\\]” , “테스트 상품 구매금지” 문구 추가 등.)\n        \n    - 유통채널에 등록한 상품은, 필요 이상으로 오래 노출되지 않도록 판매중지 해주시기 바랍니다.  \n        (당일 등록한 상품은 당일 처리 필요.)\n        \n\n### **2) 개발 환경 제한 사항**\n\n- 개발 환경에 등록가능한 최대 상품수는 1,000개 입니다.\n    \n- 최대 등록가능한 IP의 개수는 3개입니다.\n    \n\n---\n\n# 공통사항\n\n## 요청\n\n- Content-Type: application/json 또는 multipart/form-data\n    \n- 인증 : 인증토큰 발급 API를 통하여 Token 발급,  \n    Request Header Bearer Token 으로 요청\n    \n\n```\n-H Authorization: Bearer <token>\n\n ```\n\n## 응답\n\n- Content-Type: application/json\n    \n\n| 키 | 설명 |\n| --- | --- |\n| code | '0000' |\n| message | '성공' |\n| data | Response Data |\n\n- 실패 응답\n    \n\n``` json\nHTTP STATUS 401\n{\n    \"code\": \"0001\",\n    \"message\": \"접근 권한 없음\",\n    \"details\": [\n        \"jwt expired\"\n    ]\n}\n\n ```\n\n| **키** | **설명** |\n| --- | --- |\n| code | '0000' 이외의 코드 = 실패 |\n| message | 대략적인 오류 표현 |\n| details | 실패 사유에 대한 상세 내용들 (배열) |","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"38056705","collectionId":"6136315c-f570-49c1-86c3-ab125a3917b1","publishedId":"2sAYk8v3K1","public":true,"publicUrl":"https://docs.pongift.net","privateUrl":"https://go.postman.co/documentation/38056705-6136315c-f570-49c1-86c3-ab125a3917b1","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"7634CB"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"Open API 3.0"},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/eeb92dc2-f812-4d0e-8be9-d8aee8178b72/MjAyNS0wMy0yMF8xNS00Ni0yMS5qcGc=","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"7634CB"}},{"name":"light","logo":"https://content.pstmn.io/20b89e80-301c-4d2b-88f7-3c2c27b37374/MjAyNS0wMy0yMF8xNS00Ni0yMS5qcGc=","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"7634CB"}}]}},"version":"8.10.1","publishDate":"2026-03-03T07:20:43.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":"Open API 3.0"},"logos":{"logoLight":"https://content.pstmn.io/20b89e80-301c-4d2b-88f7-3c2c27b37374/MjAyNS0wMy0yMF8xNS00Ni0yMS5qcGc=","logoDark":"https://content.pstmn.io/eeb92dc2-f812-4d0e-8be9-d8aee8178b72/MjAyNS0wMy0yMF8xNS00Ni0yMS5qcGc="}},"statusCode":200},"environments":[{"name":"Open API 3.0 DEV","id":"9c6cfeb9-4f33-4e33-9814-a467a63be108","owner":"38056705","values":[{"key":"url","value":"https://openapi.pongift.net","enabled":true,"type":"default"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/39e3909bb8e359d9f7a1db47c31d4889932e12a66d2586188d1c3d1f3187d9de","favicon":"https://pongift.net/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Open API 3.0 DEV","value":"38056705-9c6cfeb9-4f33-4e33-9814-a467a63be108"}],"canonicalUrl":"https://docs.pongift.net/view/metadata/2sAYk8v3K1"}