Search
🔗

URL 링크결제 (카드 / 계좌)

이 글의 목차

1. 정의

URL링크결제는 결제링크를 생성하여 문자, 카카오톡, 이메일 등의 다양한 채널에서 고객에게 결제를 받을 수 있는 서비스입니다.
URL링크결제의 생성은 다음과 같은 경로로 수동으로 생성 가능합니다.
페이플 파트너 관리자↗ > 부가서비스 > URL링크결제 > 결제용 링크 생성하기
💡
해당 문서에서는 API를 통해 자동으로 링크를 생성하는 방법을 소개드립니다.
아래 링크를 클릭해서 URL링크결제를 직접 체험해보세요.
💡
체험링크이며, 결제된 금액은 자동 취소됩니다.

2. 프로세스 개요

3. 파트너 인증

파트너 서버

Request Message

파라미터 정보
Search
Parameter
더 알아보기
Type
Length
Parameter value
Reference
custKey
Open
String
255
abcd1234567890
파트너 인증키
PCD_PAY_WORK
Open
String
20
LINKREG
URL링크결제 생성요청 Parameter
COUNT3
Request sample
/* * TEST : https://democpay.payple.kr/php/auth.php * REAL : https://cpay.payple.kr/php/auth.php */ POST /php/auth.php HTTP/1.1 Host: democpay.payple.kr Content-Type: application/json Cache-Control: no-cache { "cst_id": "test", "custKey": "abcd1234567890", "PCD_PAY_WORK": "LINKREG" }
Plain Text
PHP 샘플코드
JAVA 샘플코드
NODE 샘플코드

Response Message

파트너 인증이 성공하면 페이플에서 파트너에 다음과 같은 성공 리턴을 드립니다.
파라미터 정보
Search
Parameter
더 알아보기
Parameter value
Reference
server_name
Open
democpay.payple.kr
파트너 인증시 페이플의 요청 URL
result
Open
success
결과확인
result_msg
Open
사용자 인증 완료!!
결과메세지
cst_id
Open
UFVNNVZpZk4reWo5UFRualUwcGV4dz09
파트너 ID
custKey
Open
T3JzRkp5L1FTcEFDa1FQdHo5Um1UZz09
파트너 Key
AuthKey
Open
a688ccb3555c25cd722483f03e23065c3d0251701ad6da895eb2d830bc06e34d
파트너 인증토큰
PCD_PAY_HOST
Open
https://democpay.payple.kr
결제요청 도메인
PCD_PAY_URL
Open
<return_uri>
결제요청 URI *고정값으로 사용하지 않기를 권장합니다.
return_url
Open
<return full uri>
결제요청 URI (PCD_PAY_HOST + PCD_PAY_URL) *고정값으로 사용하지 않기를 권장합니다.
COUNT9
Response sample
{ "server_name" => 요청 URL "result" => 결과확인, "result_msg" => 결과 메지, "cst_id" => 파트너 아이디, "custKey" => 파트너 키, "AuthKey" => 파트너 인증토큰, "PCD_PAY_HOST" => 결제요청 도메인, (예: https://democpay.payple.kr) "PCD_PAY_URL" => 결제요청 URL, (예: /auth.php) "return_url" => 결제요청 URL (PCD_PAY_HOST + PCD_PAY_URL) }
Plain Text
💡
실패 리턴 (result = error)을 받으신 경우, result_msg 의 응답코드를 확인하고 잘못된 부분을 수정합니다. 응답코드 리스트는 이 곳↗ 에서 확인하실 수 있습니다.

4. 링크생성

파트너 서버
파트너는 파트너 인증 완료 후 링크생성 요청을 수행합니다.
이때 파트너 인증 후 Response 받은 cst_id, custkey, AuthKey 값을 각각 PCD_CST_ID, PCD_CUST_KEY, PCD_AUTH_KEY 에 넣어 취소 요청을 보냅니다.
‼️
파트너 인증 후 Response 받은 cst_id, custKey,AuthKey 값은 고정값이 아니므로 저장해놓고 계속해서 사용하면 안됩니다. + 해당 값의 유효기간은 30분입니다. + 한번의 파트너 인증과 하나의 요청이 매칭되어야 합니다. 즉 한번의 파트너 인증으로 받은 cst_id, custKey,AuthKey 값을 여러 요청에 사용하면 안됩니다.

Request Message

필수 파라미터 정보
Search
결제수단
Parameter
더 알아보기
Type
Length
Parameter value
Reference
카드
계좌
PCD_CST_ID
Open
String
255
UFVN...
파트너 인증 후 리턴 받은 cst_id Token
카드
계좌
PCD_CUST_KEY
Open
String
255
T3Jz...
파트너 인증 후 리턴 받은 custKey Token
카드
계좌
PCD_AUTH_KEY
Open
String
255
a688c...
파트너 인증 후 리턴 받은 인증 Token
카드
계좌
PCD_PAY_WORK
Open
String
20
LINKREG
링크결제 요청방식
카드
계좌
PCD_PAY_TYPE
Open
String
20
card
결제수단 선택 (카드: card, 계좌: transfer)
카드
계좌
PCD_PAY_GOODS
Open
String
2048
티셔츠
카드
계좌
PCD_PAY_TOTAL
Open
Number
20
1000
결제 요청금액
선택 파라미터 정보
Search
결제수단
Parameter
더 알아보기
Type
Length
Parameter value
Reference
카드
계좌
PCD_PAY_ISTAX
Open
String
1
Y
과세설정 (Default: Y 이며, 과세:Y, 복합과세:Y, 비과세: N) ISTAX:Y, TAXTOTAL:공란이면 페이플에서 10% 부가세를 자동으로 적용합니다.
카드
계좌
PCD_PAY_TAXTOTAL
Open
Number
11
10
복합과세(과세+면세) 주문건에 필요한 금액이며 가맹점에서 전송한 값을 부가세로 설정합니다.과세 또는 비과세의 경우 사용하지 않습니다.
카드
계좌
PCD_LINK_EXPIREDATE
Open
String
8
20210806
링크결제의 만료일을 지정합니다. 지정하지 않는 경우 무기한 결제가 가능합니다.
Request sample
/* * 링크생성 요청 * TEST : https://democpay.payple.kr * REAL : https://cpay.payple.kr */ POST 가맹점 인증 후 리턴받은 PCD_PAY_URL HTTP/1.1 Host: 가맹점 인증 후 리턴받은 PCD_PAY_HOST Content-Type: application/json Cache-Control: no-cache { "PCD_CST_ID": "파트너 인증 후 리턴받은 cst_id", "PCD_CUST_KEY": "파트너 인증 후 리턴받은 custKey", "PCD_AUTH_KEY": "파트너 인증 후 리턴받은 AuthKey", "PCD_PAY_WORK": "LINKREG", "PCD_PAY_TYPE": "card", "PCD_PAY_GOODS": "상품1", "PCD_PAY_TOTAL": 100, "PCD_LINK_EXPIREDATE": 20200806 }
JavaScript

Response Message

응답 파라미터 정보
Search
Parameter
더 알아보기
결제수단
Parameter value
Reference
PCD_LINK_RST
Open
카드
계좌
success
요청 결과(success, error)
PCD_LINK_MSG
Open
카드
계좌
링크생성이 완료되었습니다.
링크생성 요청 결과 메시지
PCD_PAY_TYPE
Open
카드
계좌
card
결제수단 - 카드: card - 계좌이체: transfer
PCD_PAY_GOODS
Open
카드
계좌
상품1
상품명
PCD_PAY_TOTAL
Open
카드
계좌
100
결제금액 총액
PCD_PAY_ISTAX
Open
카드
계좌
Y
과세설정 (Default: Y 이며, 과세:Y, 복합과세:Y, 비과세: N)
PCD_PAY_TAXTOTAL
Open
카드
계좌
0
복합과세(과세+면세) 주문건에 필요한 금액이며 가맹점에서 전송한 값을 부가세로 설정 과세 또는 비과세의 경우 사용하지 않습니다.
PCD_TAXSAVE_FLAG
Open
카드
계좌
Y
현금영수증 발행창을 노출하는 옵션Parameter입니다. (사용: Y)
PCD_LINK_EXPIREDATE
Open
카드
계좌
20200806
링크결제의 만료일을 지정합니다.
PCD_LINK_KEY
Open
카드
계좌
Mj...
링크요청 키
PCD_LINK_URL
Open
카드
계좌
https://..
생성된 링크 URL이며, 결제를 위해 고객에게 전달되어야 합니다.
COUNT11
응답 예시
‼️
PCD_LINK_RST = success 요청성공으로 판단합니다. PCD_LINK_RST = error 일 경우 요청실패로 판단합니다.
💡
실패 리턴(PCD_LINK_RST = error )을 받으신 경우, PCD_LINK_MSG 의 응답코드를 확인하고 잘못된 부분을 수정합니다. 응답코드 리스트는 이 곳↗ 에서 확인하실 수 있습니다.

5. 링크 전달

파트너
링크생성이 완료되고 리턴받은 PCD_LINK_URL 에 있는 링크주소를 고객에게 전달합니다.
💡
거래를 특정하기 위해 링크주소에 주문번호(PCD_PAY_OID)를 지정하고 싶다면 이 문서↗를 확인해보세요.

6. 결제

고객
고객은 전달받은 링크주소로 접속해서 결제방식을 선택하고, 결제를 진행합니다.

7. 결과 수신

파트너
링크결제를 완료하고, 파트너가 결제이벤트 정보를 확인하는 방법은 다음과 같습니다.

7-1. 파트너 관리자

페이플 파트너 관리자↗ > 결제수단(계좌이체, 신용카드) 별 결제내역 혹은
페이플 파트너 관리자↗> 부가서비스 > URL링크결제 > 링크별 결제완료 텍스트 클릭 > 완료된 링크결제 내역 에서 확인 가능합니다.

7-2. 이메일

페이플에 등록된 파트너사의 대표이메일로 결제가 발생할때마다 메일이 발송됩니다.
페이플 파트너 관리자↗> 상점정보 > 기본정보 > 대표이메일 에서 이메일 설정 현황을 확인 가능합니다.

7-3. Webhook URL

등록한 Webhook URL로 결제결과를 수신받을 수 있습니다.
페이플 파트너 관리자↗> 상점정보 > 기본정보 > 결제결과 수신 URL & 계좌(카드)해지결과 수신 URL 에서 설정정보 확인이 가능합니다.
🔗
Webhook URL에 대한 자세한 설명은 이곳↗에서 확인해보세요.

7-4. slack(슬랙)

사용하시는 슬랙의 특정 채널로 링크결제시 결과를 수신 받을 수 있습니다.
페이플 파트너 관리자↗> 상점정보 > 환경설정 > Push 알림 에서 설정정보 확인이 가능합니다.
🔗
설정방법에 대한 자세한 설명은 이곳↗에서 확인해보세요.

8. 마무리

URL링크결제의 연동작업을 완료하였습니다! 축하드립니다!🎉
TOP