1. 정의
•
지급이체 요청(request)정보 조회란 하나의 그룹(group_key)에 묶인 지급이체 요청(request)건들을 조회하는 기능입니다. (group_key로 지급이체 실행전 요청건을 한번 더 확인하기 위함입니다.)
지급이체 요청(request)정보 조회를 이용하여 group_key에 묶인 지급이체 요청(request)건만을 건별로 확인할 수 있습니다. 즉, 지급이체가 완료되었거나 요청 취소, 실패 등 '요청'상태가 아닌 건은 포함되지 않습니다.
2. 프로세스 개요
3. 토큰발급
파트너 서버
•
파트너 인증을 위한 토큰발급을 진행해야합니다.
발급받은 access_token은 이후 다른 요청에서 필요하며, 토큰의 만료기간(60초)이 지나면 다시 토큰을 발급받으셔야 합니다.
⦁ 파트너에서는 access_token 유효기간에 맞춰서 유효한 토큰값 유지를 위한 로직을 구현하셔야 합니다.
페이플 허브에서는 사용자 인증을 OAuth 2.0으로 진행합니다.
Request Message
code는 반드시 영문자+숫자만 포함하여 10자만 입력해야합니다.
기본 보기
Search
Request sample
•
Header 정보
/*
* Request HTTP URL
* TEST : https://demohub.payple.kr/oauth/token
* REAL : https://hub.payple.kr/oauth/token
*/
Request HTTP URL: "https://demohub.payple.kr/oauth/token"
HTTP Method: POST
Content-Type: application/json
Cache-Control: no-cache
JSON
복사
•
Body(Payload) 값
{
"cst_id":"test",
"custKey":"abcd1234567890",
"code":"as12345678"
}
JSON
복사
Response Message
•
토큰발급 요청이 성공하면 페이플에서 파트너에 다음과 같은 성공 리턴을 드립니다.
기본 보기
Search
Response sample
{
"result":"T0000",
"message":"처리 성공",
"code":"as12345678",
"access_token":"eyJhlNDlj...",
"token_type":"Bearer",
"expires_in":"60"
}
JSON
복사
result= "T0000", message= "처리 성공"인 경우 요청 성공으로 판단합니다.
발급받은 access_token은 모든 요청에 Authorization 값으로 필요합니다.
4. 지급이체 요청(request)정보 조회
파트너 서버
•
파트너는 토큰발급 후 지급이체 요청(request)정보 조회 요청을 수행합니다.
Request Message
기본 보기
Search
Request example
•
Header 정보
/*
* Request HTTP URL
* TEST : https://demohub.payple.kr/request/result/group_key
* REAL : https://hub.payple.kr/request/result/group_key
*/
Reauest HTTP URL: "https://demohub.payple.kr/request/result/group_key"
HTTP Method: POST
Content-Type: application/json
Cache-Control: no-cache
Authorization: Bearer, Access Token
JSON
복사
$arrObHeader = array (
"Authorization: Bearer $paypleToken[access_token]",
"Accept: application/json"
);
PHP
복사
PHP - Header 값 설정 예시
•
Body(Payload) 값
{
"cst_id":"test",
"custKey":"abcd1234567890",
"group_key": "Q0RSSkYzWUI3..."
}
JSON
복사
Response Message
•
지급이체 요청(request)정보 조회가 성공하면 페이플에서 파트너에 다음과 같은 성공 리턴을 드립니다.
지급이체 요청(request) 상태인 건들에 대해서만 결과가 리턴됩니다.
⦁ 지급이체 실행완료, 요청 취소, 실패 등인 건들은 조회되지 않습니다. 즉, group_key내에 존재하는 요청건들에 대해서만 조회됩니다.)
기본 보기
Search
Response example
{
"result": "A0000",
"message": "처리 성공",
"total": "4000",
"count": "4",
"list": [
{
"cst_id": "test",
"sub_id": "test12385610",
"group_key": "Q0RSSkYzWUI3...",
"billing_tran_id": "2g4493dc-...",
"print_content": "정산테스트2",
"tran_amt": "1000",
"remain_amt": "9988000",
"request_date": "2021-10-26 10:55:03"
},
{
"cst_id": "test",
"sub_id": "test12385610",
"group_key": "Q0RSSkYzWUI3...",
"billing_tran_id": "2g4493dc-...",
"print_content": "정산테스트2",
"tran_amt": "1000",
"remain_amt": "9987000",
"request_date": "2021-10-26 10:55:03"
},
{
"cst_id": "test",
"sub_id": "test12385610",
"group_key": "Q0RSSkYzWUI3...",
"billing_tran_id": "2g4493dc-...",
"print_content": "정산테스트2",
"tran_amt": "1000",
"remain_amt": "9986000",
"request_date": "2021-10-26 10:55:04"
},
{
"cst_id": "test",
"sub_id": "test12385610",
"group_key": "Q0RSSkYzWUI3...",
"billing_tran_id": "2g4493dc-...",
"print_content": "정산테스트2",
"tran_amt": "1000",
"remain_amt": "9985000",
"request_date": "2021-10-26 10:55:05"
}
]
}
JSON
복사
result= "A0000", message= "처리 성공"인 경우 요청 성공으로 판단합니다.