teledit client install manual - miju24 - 이사견적 비교 · web viewgyeonggi-do, 463-825, korea...

INSTALL MANUAL FOR C P C ORPORATE

Danal 휴대폰결제 연동 가이드

7F HUMAX Village 11-4 Sunae-dong, Bundang-gu, Seongnam-si,

Gyeonggi-do, 463-825, KoreaEmail. [email protected]

Payment Development

This document is a property of DANAL Technologies Private Limited. No part of this document may be copied or reproduced in any form

or by any means, electronic, mechanical or otherwise without the prior written permission of DANAL Technologies Private Limited.

목차

1. 개요..............................................................................................................2

A. 사전 준비사항...................................................................................................................2B. 휴대폰결제시스템 연동 순서...............................................................................................2C. System Requirement..................................................................................................2

2. DANALPAY....................................................................................................3

A. Service Diagram.........................................................................................................3B. Service Flow................................................................................................................3C. 각 페이지 설명..................................................................................................................4

a. CGI Script 페이지........................................................................................................4b. Function.....................................................................................................................4c. Ready.........................................................................................................................5d. Start...........................................................................................................................9e. Deliver......................................................................................................................10f. Deliver2....................................................................................................................11g. Report......................................................................................................................12h. CPCGI........................................................................................................................13i. CPCGI........................................................................................................................14

D. 결제완료 후 확인되는 값(CPCGI).....................................................................................15E. CP 주의사항..................................................................................................................15

3. 거래 취소......................................................................................................16

A. 취소 Process Diagram.............................................................................................16B. 취소 방법.....................................................................................................................16

Copyright Danal Payment Development Team. All Rights Reserved1

개요이 문서는 휴대폰 결제 시스템(DanalPay)의 이해를 돕고 시스템 연동에

도움이 되고자 작성되었으며, 각 프로세스 및 Parameter 등 결제시스템

연동에 필요한 내용에 대해 설명한다

A. 사전 준비사항

i. 방화벽 설정 : Outbound 방화벽 사용하는 CP일 경우 아래내용 참조

서버 IP PortCP 인증 서버 trans.teledit.com 31000

결제거래 서버 211.170.89.1 ~ 211.170.89.15 5505

취소 서버 trans.teledit.com 13003

ii. http://tech.danal.co.kr 접속 – ClientModule, CGI Script, Manual 다운로드

B. 휴대폰결제시스템 연동 순서

a. ClientModule 설치 (설치방법은 ClientModule 매뉴얼 참조)b. CP정보입력 및 경로수정 (Ready.* , function.*)c. 결제완료 후(CPCGI) CP작업 시행 (서비스제공, TID 저장, DB 관련작업 등)

C. System Requirement

i. Linux / Sun OS / Windows 계열/ FreeBSD / AIX 등 모든 OS 지원

ii. PHP / JSP / ASP 등


http://tech.danal.co.kr/

2.DanalPay다날 휴대폰 결제 서비스의 구성 및 흐름 등에 관하여 설명한다

A. Service Diagram총 5단계로 진행이 되며, B와 C의 단계는 다날 웹서버(다날 표준결제창)를

사용하거나, CP웹서버(CP 자체결제창)를 사용할 수 있다

B. Service Flow아래의 순서대로 결제 진행이 된다


Ready Start Deliver Deliver2 Report CPCGI

ITEMSEND2

Report Confirm

Bill

Deliver

CP인증상품정보전송

고객정보입력 사용자인증 및승인번호전송

승인번호입력 승인번호확인 결제인증 및 결제완료

UI UI

CP인증 및 상품정보 전송상품선택

응답, 거래아이디전송사용자정보 입력 폼 제공

사용자정보 입력사용자정보 전송

응답승인번호 입력 폼 제공

승인번호 입력승인번호 인증 요청

응답URL RedirectionURL Redirection

Confirm

응답

Bill

응답서비스제공

A

B

C

D

E

CPUSER PG

C. 각 페이지 설명

a. CGI Script 페이지

파일 설명

./inc/function.* 공통 Function 정의

Ready.* CP 및 상품정보 전송 페이지

Start.* 사용자 정보 입력 화면

Deliver.* 인증요청 (사용자정보확인, 승인번호(OTP)요청)Deliver2.* 승인번호(OTP) 입력 화면

Report.* 승인번호(OTP) 확인

CPCGI.* 결제 최종 요청 페이지

Error.* 에러페이지

b. Functioni. 역할 : 휴대폰결제서비스에서 필요한 Function 정의

ii. 수정사항

(아래 값은 예시 및 Default 값이며, 경로수정이 필요한 경우만 참조)

function.php $TeleditBinPath = “./bin”;

function.jsp String TeleditBinPath = ”C:\Teledit\bin”;

function.asp 수정사항 없음


c. Ready i. 역할 : CP인증 (A 단계)ii. 설명 : CP정보(ID, PWD) 및 상품정보(ItemAmt, ItemName, ItemCode등)을

서버로 전송

iii. 연동방법 : Library 연동

int f_RegistItem(char *input, char *output) 을 호출 하거나

int SecureClient(char *input, char *output) 을 호출

Binary 연동

RegistItem 또는 SClient 사용

iv. Parameter INPUT

FieldRequire

dMax(Byte

)비고 (Example Value)

CP 정보

ID Required 10 CP ID PWD Required 10 CP PWD

SUBCP OptionalSub CPID(SubCPID 사용하는 CP경우)

사용자 정보

IPADDR Required 15 고객 접속 IPUSERID Optional 60 고객 IDEMAIL Optional 100 고객 EMAIL

상품 정보

ItemType Required - 상품 Type (고정값 -“Amount”)ItemCount Required - 상품 개수 (고정값 -“1”)ItemInfo Required - 상품 정보 (아래 ItemInfo 구성참조)OrderID Optional 200 CP 주문번호

기본정보

SERVICE Required - “TELEDIT” – 고정값

Command Required - “ITEMSEND2”– 고정값(SClient 사용시)

OUTPUT

FieldRequire

dMax(Byt

e)비고 (Example Value)

기본 정보

Result Required 4 결과 코드

ErrMsg Required 256 결과 메시지


ServerInfo Required 128 거래인증 key


v. Parameter값 실제 전송형태 예제

vi. ItemInfo (상품 정보) 구조

ItemInfo = <UnitType>|<ItemAmt>|<UnitCount>|<Itemcode>|<ItemName>

ItemInfo Parameter 설명

<UnitType> := 컨텐츠(1) / 실물(2)<ItemAmt> := 상품 금액

<UnitCount>:= 상품 개수

<ItemCode> := 상품 코드(10byte)<ItemName> := 상품 명(80byte)[ 금칙어 : ; (semicolon), = (equal), ‘ (single quotation), |

(pipe) ]

예제

ItemInfo=1|500|1|1270000000|TestItem


“Command=ITEMSEND2; ID=test;PWD=test;ItemType=Amount;ItemCount=1;ItemInfo=1|0|1|1270000000|test;SERVICE=TELEDIT;[email protected];IPADDR=127.0.0.1;USERID=USER”

d. Starti. 역할 : 휴대폰번호, 주민번호, 이메일 등 사용자정보 입력 폼

ii. 설명 : 기입된 정보를 다음단계로 전송한다

iii. UI


e. Deliveri. 역할 : 사용자인증단계 (B 단계)ii. 설명 : 결제한도, 이용요금, 분실, 사용자의 전화번호/주민번호의 일치

등 사용자 정보를 검사하며, SMS승인번호를 사용자에게 전송한다

iii. 연동방법

Library 연동 방법

int f_EDeliver(char *input, char *output) 또는

int SecureClient(char *input, char *output) binary 연동 방법

EDeliver 또는 SClient를 이용한다

iv. Parameter INPUT

FieldRequire

dMax(Byte


사용자 정보

DstAddr Required 14 전화번호

Iden Required 13 주민번호

Carrier Required 4 통신사 구분 (SKT, KTF, LGT)EMAIL Optional 100 사용자 mail 주소

Monpay Optional 1첫 자동결제 구분 flag1: 첫 자동결제

0: 첫 자동결제가 아님

기본정보

ServerInfo Required 128 거래인증 keyCommand Required - “DELIVER”–고정 값(SClient 사용시)

OUTPUT

FieldRequire

dMax(Byt


기본 정보



CAP Required 6 결제 가능 한도 금액



"Command=DELIVER; ServerInfo=XXXXXXXXXXXXXX;DstAddr=XXXXXXXXXX;Iden=XXXXXXXXXXXXX;Carrier=XXX;[email protected]”

f. Deliver2i. 역할 : SMS 승인번호 입력 창

ii. 설명 : Deliver 과정을 통하여 전송된 SMS 승인번호 (OTP)를 입력

받는다

입력 받은 승인번호(OTP)를 다음 과정(Report)으로 넘겨 승인번호를

확인한다

iii. UI


g. Reporti. 역할 : 승인번호 인증단계(C 단계)ii. 설명 : 전송한 승인번호와 입력된 승인번호를 비교하여 일치하면

다음단계로 전송

iii. 연동방법 : library 연동 방법

int f_EReport(char *input, char *output) 또는

int SecureClient(char *input, char *output) 을 호출한다. binary 를 이용한 연동

EReport 또는 SClient를 이용한다.

iv. Parameter INPUT

FieldRequire

dMax(Byte


기본정보

ServerInfo Required 128 거래인증 keyOTP Required 6 SMS로 전송된 승인번호

Command Required - “REPORT” – 고정 값(SClient 사용시)

OUTPUT

FieldRequire

dMax(Byt


기본 정보



EncodedTID Required 48 Confirm에서 사용하기 위한 data



" Command=REPORT;ServerInfo=XXXXXXXXXXXXX;OTP=XXXXXX”

h. CPCGIi. 역할 : 결제 검증 단계(D 단계)ii. 설명 : OrderID 또는 결제금액 등 결제 거래내용에 대한 검증을 반드시

해야 하며, 성공할 경우 다음단계로 이동한다

iii. 연동방법

library 연동 방법

int f_Confirm(char *input, char *output) 또는

int SecureClient(char *input, char *output) 을 호출한다. binary를 이용한 연동

Confirm 또는 SClient를 이용한다.

iv. Parameter INPUT

FieldRequire

dMax(Byte


기본정보

ServerInfo Required 128 거래인증 keyEncodedTID Required 48 이전 단계에서 받은 dataCommand Required - “CONFIRM” –고정값(SClient 사용시)

OUTPUT

FieldRequire

dMax(Byt


기본 정보



CAP Required 6 한도 금액

TotalAmount Required 6 거래 금액

TID Required 18 거래 Unique KeyOrderID Optional 200 CP주문번호



"Command=CONFIRM; ServerInfo=XXXXXXXXXXXXX;EncodedTID=XXXXXXXXXXX”

i. CPCGIi. 역할 : 결제요청 (E 단계)ii. 설명 : 인증이 완료된 거래에 대하여 Bill을 수행한다

E 단계까지 성공하여야 실제 청구가 되며 , 이전단계까지

성공하였다 하더라도, E 단계가 실행되지 않으면 결제가 완료된 것이 아니다

Confirm 실행 후 CP의 금액과 Result의 “TotalAmount”값을

반드시 비교하여 올바른 결제 건이면 Bill을 수행하도록 한다.

iii. 연동방법 : library 연동 방법

int f_Bill(char *input, char *output) 또는

int SecureClient(char *input, char *output) 을 호출한다

binary를 이용한 연동

Bill 또는 SClient를 이용한다.

iv. Parameter INPUT

FieldRequire

dMax(Byte


기본정보

ServerInfo Required 128 거래인증 keyCommand Required - “BILL” – 고정 값(SClient 사용시)

OUTPUT

FieldRequire

dMax(Byt


기본 정보



Date Required 14 결제 완료 시간

TID Required 18 거래 Unique Key



" Command=BILL; ServerInfo=XXXXXXXXXXXXXXXX;”

D. 결제완료 후 확인되는 값(CPCGI)

i. Result DataResult : 결제 결과 (0:성공)TID : 거래 Unique KeyCAP : 한도금액

TotalAmount : 결제된 금액

ii. Form DataCarrier : 통신사 (SKT/KTF/LGT)OTP : 승인번호

Info : 결제 전화번호, 주민등록번호 (|TelNum=xxxxxxxxxxx|Iden=xxxxxxxxxxxxx)

By~~~ : Ready 에서 입력한 변수

E. CP 주의사항i. Bill이 성공적으로 수행된 이 후(Result=0), 이용자에게 서비스를

제공한다

ii. 결제건의 대사, 취소를 위하여 TID(18byte)를 저장한다


3.거래 취소

A. 취소 Process Diagram

B. 취소 방법

a. 관리자 페이지에서 취소

https://cp.teledit.com 로그인후, 거래확인/취소에서 취소 가능

b. 취소 모듈을 이용한 취소

library 연동 방법

int f_Cancel(char *input, char *output) 을 호출

binary를 이용한 방법

BackDemo 또는 AutoCancel 이용

i. Parameter Input

FieldRequire

dMax(Byte


기본정보

ID Required 10 CPIDPWD Required 10 CP passwordTID Required 18 거래 Unique Key

Output

FieldRequire

dMax(Byt


결과정보


ErrMsg 실패시 256 결과 메시지

TID Required 18 거래 Unique KeyDate 성공시 14 취소 시간


취소요청

CP PG

취소응답

https://cp.teledit.com/

teledit client install manual - miju24 - 이사견적 비교 · web viewgyeonggi-do, 463-825, korea...

Documents