외국인을 상대로한 쇼핑몰을 만들거나, 외국인을 상대로 거래를 하는 사이트를 만들때 Paypal의 연동은 필수라 할 수 있습니다. 인터넷을 많이 뒤져봤지만 한글로 된 문서를 발견하기가 어려웠기에 외국 사이트들을 검색하다가 이것이 페이팔측에서 제공하는 정보로도 구현이 가능하다는 것을 알았습니다. 생각해보면 당연히 그래야겠죠. PHP프로그램에 대해서 조금이라도 지식이 있다면, 아래 제가 해석해 놓은 설명서 보고 간단히 구현이 가능할 겁니다.
페이팔 연동모듈 한글화 설명서
-------------------------------------
다운로드는 http://www.paypal.com/pdn에서 받을 수 있습니다.
readme부분을 한글화 하였습니다. by 오자히르
설치
------
포함된 php_toolkit.zip의 압축을 풀어서 당신이 운영하는 웹사이트의 루트에 업로드합니다.
예를들어 당신의 웹사이트 루트가 /home/yoursite/www라면
/home/yoursite/www/php_toolkit에 압축을 풀은 파일들이 위치하도록 하면 됩니다.
다음으로 Includes폴더의 config.inc.php을 열어서 Paypal 계정의 설정을 한다.
설정정보
-----------
PHP ToolKit의 설정은 당신의 주문Form의 변수들을 config.inc.php파일안에 입력해주기만 하면 될정도로 간단합니다. 대부분의 설정 옵션들은 Paypal에 맞게 이미 입력되어있습니다.
파일 설명
------------
config.inc.php
주요 설정을 담고있다.
global_config.inc.php
이 프로그램에 쓰이는 전역(global) 함수를 담고있다.
payment.php
테스트를 위해서 미리 설정된 지불버튼이다.
orderform.php
테스트를 위해서 미리 설정된 주문버튼이다.
process.php
다음 절차를 위해 거래 정보를 페이팔로 보낸다.
success.php
페이팔로 보낸 거래 정보가 승인되었을때 나타나는 파일.
cancelled.php
페이팔로 보낸 거래 정보가 실패했을때 나타나는 파일.
styles.css
스타일시트 파일
ipn.php
페이팔의 API로부터 되돌아오는 정보를 받아 결과를 해석한다.
ipn_success.php
IPN거래가 성공하면 실행한다.
ipn_error.php
IPN거래가 실패하면 실행한다.
설정
-------
다음의 변수들은 config.inc.php파일에서 설정이 가능하다.
$paypal[url] (필수)
PayPal API URL
$paypal[post_method] (필수)
Post Methods: fso (PHP가 OpenSSL지원하도록 컴파일 되었을경우)
curl(libCurl을 지원하도록 컴파일 되었을경우.) 잘모르겠으면 fso그대로
$paypal[curl_location] (선택)
cURL이 웹서버에 설치되어있다면, CURL의 경로를 설정한다.(예. /usr/bin/curl)
$paypal[business] (필수)
페이팔 계정의 이메일 주소
$paypal[site_url] (선택)
이 스크립트가 실행될 URL주소를 적는다. 뒤에 /를 적는다.(예: http://www.paypalsolutions.com/)
$paypal[image_url] (선택)
당신의 로고로써 원하는 150x50픽셀의 이미지 파일의 URL
$paypal[success_url] (선택)
사용자가 지불에 성공하고 이동될 페이지 주소
$paypal[cancel_url] (선택)
사용자가 지불에 실패하고 이동될 페이지 주소
$paypal[notify_url] (선택)
: IPN통지 스크립트의 주소
설명서의 설명이 약간 부족한 감이 있어서 좀 덧붙이겠다.
아마 이것은 ipn/ipn.php로 잡혀있을 것이다. 이 파일을 열어보았는데
if(eregi("VERIFIED",$result))
{ include_once('./ipn_success.php'); }
else
{ include_once('./ipn_error.php'); }
이런 부분이 있었다. 처리결과에서 VERIFIED가 있는지 대소문자 구분없이 살펴서 있다면
ipn_success.php를 실행시키고 실패하면 ipn_error.php를 실행시키게 된다.
$paypal[return_method] (선택)
URL을 넘길때 폼을 GET으로 넘길지 POST로 넘길지 설정한다. 기본값은 GET이다.
$paypal[currency_code] (선택)
지불될 통화를 설정한다. (예. USD, EUR, GBP)
$paypal[lc] (선택)
손님이 당신의 버튼을 누를때 어떤 언어로 로그인을 할 지 정해준다.
그대로 두면 영어("US")로 된다.
$paypal[display_comment] (선택)
코멘트를 출력하고 싶다면 0을 적는다 아니면 1이다
$paypal[comment_header] (선택)
출력할 코멘트를 적는다.
$paypal[background_color] (선택)
돈을 지불할 때 페이지의 배경색을 정해준다. 1=검은색, 공란=흰색
$paypal[display_shipping_address] (선택)
배송 주소를 표시할 것인가를 적는다.
$paypal[item_name] (선택)
(선택)아이템 설명
$paypal[item_number] (선택)
상품의 아이템 번호
$paypal[amount] (선택)
구입 가격/량을 적는다. 배송비나 세금은 포함하지 않고 적는다.
$paypal[on0] (선택)
옵션 필드의 이름을 적는다.(보통은 필요없다)
First option field name.
$paypal[os0] (선택)
옵션 필드의 값을 적는다.(보통은 필요없다)
$paypal[on1] (선택)
두번째 옵션 필드의 이름을 적는다.(보통은 필요없다)
$paypal[os1] (선택)
두번째 옵션 필드의 값을 적는다.(보통은 필요없다)
$paypal[quantity] (선택)
구입될 량
$paypal[edit_quantity] (선택)
1로 설정하면 구입할 양을 사용자가 변경할 수 없다.
$paypal[invoice] (선택)
거래 송장 번호
$paypal[tax] (선택)
거래에 적용할 세금.
$paypal[shipping_amount] (선택)
Flat shipping amount to charge.
$paypal[shipping_amount_per_item]
Flat shipping amount to charge for each additional item.
$paypal[handling_amount] (선택)
취급비
$paypal[custom_field] (선택)
커스텀 주문 폼
$paypal[firstname] (선택)
구입자 이름
$paypal[lastname] (선택)
구입자 성
$paypal[address1] (선택)
구입자 주소
$paypal[address2] (선택)
구입자 주소2
$paypal[city] (선택)
구입자 도시
$paypal[state] (선택)
주입자 주
$paypal[zip] (선택)
구입자 ZIP코드(우편번호)
$paypal[email] (선택)
구입자 이메일
$paypal[phone_1] (선택)
구입자 지역번호
$paypal[phone_2] (선택)
구입자 전화번호의 첫3자
$paypal[phone_3] (선택)
구입자 전화번호 나머지4자
