수기결제 API 전문

수기결제 연동 HISTORY

일자버전변경사항비고

2019. 10. 01

v 1.0.0

수기결제
( 카유 : 카드번호 / 유효기간,
카유비생 : 카드번호 / 유효기간 / 비밀번호 앞 2자리 / 생년월일 )


2020.02.13
V1.1
휴대전화 인증 기능 추가





수기결제 연동 요약

결제흐름



결제방식 (요약)
  • 통신방식 : 소켓(Socket) 통신
  • 네트워크 프로토콜 : SSL(443)
  • 요청주소(Host) : pay2pay.co.kr
  • 요청데이터 형식
    • 형식 : 이름=값&이름=값&...
    • 예 ) card_no=2222333344445555&cardvalid_ym=2207&...
  • 응답데이터 형식
    • 형식 : 이름=값(줄바꿈)이름=값(줄바꿈)
    • 예 ) result_code=6011
             error_msg="카드 유효 기간이 상이합니다" 

문의
  • 운영 : 02 - 6093 - 3355
  • 개발 : 02 - 2065 - 1437
  • 이메일 : sales@pay2pay.co.kr

결제화면 샘플페이지 및 예제코드

결제화면 샘플페이지 (제휴사에서 UI 맞게 제작)

- 카유 : 카드번호 / 유효기간

- 카유비생 : 카드번호 / 유효기간 / 비밀번호 앞 2자리 / 생년월일



예제코드 (PHP)
<?php
    // 페이투페이 - 고객사 안내용 예제 코드
    $host = "pay2pay.co.kr"; // 요청주소
    $send_data = "card_no=2222333344445555&cardvalid_ym=2207"; // 요청 데이터
    $url = "POST /_out/pay/direct.php HTTP/1.0\r\n";
    $sock = fsockopen("ssl://".$host, 443, $errno, $errstr);

    if($sock) {
        fwrite($sock, $url);
        fwrite($sock, "Host: " . $host . ":" . 443 . "\r\n");
        fwrite($sock, "Content-type: application/x-www-form-urlencoded\r\n");
        fwrite($sock, "Content-length: " . strlen($send_data) . "\r\n");
        fwrite($sock, "Accept: */*\r\n");
        fwrite($sock, "\r\n");
        fwrite($sock, $send_data . "\r\n");
        fwrite($sock, "\r\n");

        // 응답 데이터
        $bodys = '';

        while(!feof($sock)){
            $headers=fgets($sock,4096);
            if($headers=="\r\n"){
                break;
            }
        }

        while(!feof($sock)){
            $bodys.=fgets($sock,4096);
        }
    }
   
    var_dump($sock, $headers, $bodys);

결제승인 요청 및 결과 API 전문

 승인요청 URL
/_out/pay/direct.php

요청 전문 정의서
필드명변수명길이필수변수설명
계정 아이디vendor_id20O- 페이투페이에서 제공 (연동 키 값)
계정 CrossKeycross_key50O
- 페이투페이에서 제공 (연동 키 값)
결제타입pay_type2O
수기 ( 1 ), 수기 (4)
카드번호card_no16O
유효기간 - 년월cardvalid_ym4O
YYMM ( 예 : 2018년 10월 => 1810 )
할부개월sell_mm2O
00 : 일시불, 01 : 1개월, 02 : 2개월 ...
결제금액
(승인금액)
amt10O
총 결제금액 : 숫자(0~9) 만 사용가능
  ※ 공백, 작은따옴표( ' ), 큰따옴표 ( " ) 사용불가
주문번호order_no70O
* 제휴사에서 직접 생성
주문 식별값, 쇼핑몰 주문번호 (식별번호)
  ※ 공백, 작은따옴표( ' ), 큰따옴표 ( " ) 사용불가
결제자 성명buyer_nm20O

결제자 E-mailemail_addr50O

비밀번호password_no2
카드 비밀번호 앞 2자리
생년월일registry_no13
카드 소유자 주민번호 앞자리 (최대 13자리)
* [개인카드] 혹은 [법인 개별카드]일 경우 필수
사업자번호biz_no20카드 소유 회사 사업자번호 (최대 20자리)
* [법인 공용카드]일 경우 필수
인증키
verify_key
30
X

인증번호
verify_code
20
X

휴대전화로 받은 인증번호 입력

※ verify_key 값이 있으면 입력 필요

<휴대전화 인증 API 참고>

상품코드product_cd1000X
여러 상품의 경우 구분자 이용 : 구분자 ('||' : 파이프 2개)
  ※ 공백, 작은따옴표( ' ), 큰따옴표 ( " ) 사용불가
상품명product_nm1000X
여러 상품의 경우 구분자 이용 : 구분자 ('||' : 파이프 2개)
쇼핑몰 회원 IDpmember_id20X
쇼핑몰 결제자 ID, 제휴사 회원 ID
  ※ 공백, 작은따옴표( ' ), 큰따옴표 ( " ) 사용불가
추가필드 1etc1
200X

추가필드 2
etc2
200X

추가필드 3
etc3200X


O : 필수, : 카드사 조건에 따라 선택 필수, X : 선택


결과 전문 정의서
필드명변수명길이필수변수설명
결과코드result_code4O

정상 : 0000, 그 외 에러

결과메세지
error_msg400O

거래번호tr_no22O
고유거래번호 (페이투페이 리턴 키값)
* 결제취소시 활용
주문번호order_no70O
* 제휴사에서 제공한 주문번호
승인금액amt10X

승인번호accept_no10X

승인일시accept_date14X
카드사 Codecard_code2X
카드사 코드
카드사 명card_nm20X
카드사 명
할부개월sell_mm2X
00 : 일시불, 01 : 1개월, 02 : 2개월 ...
추가필드 1
etc1200X

추가필드 2
etc2200X

추가필드3
etc3200X

O : 필수, : 카드사 조건에 따라 선택 필수, X : 선택

결제취소 요청 및 결과 API 전문

취소요청 URL
/_out/pay/cancel.php

요청 전문 정의서
필드명변수명길이필수여부변수설명
계정 아이디vendor_id20O

계정 CrossKeycross_key50O

거래번호tr_no22O
고유거래번호
취소금액amt10O

취소사유cancel_memo50X

O : 필수, : 카드사 조건에 따라 선택 필수, X : 선택


결과 전문 정의서
필드명변수명길이필수여부변수설명
결과코드result_code4O
정상 : 0000, 그 외 에러
결과메세지error_msg400O

취소일시cancel_date14X

O : 필수, : 카드사 조건에 따라 선택 필수, X : 선택

매출전표 요청 API 전문

 전표 URL (웹 브라우저에서 확인)
  • 이 기능은 소켓 통신이 아니라 웹 브라우저로 URL 요청해야 합니다.

            예 : https://pay2pay.co.kr/_out/pay/receipt.php?tr_no=(고유거래번호 22자리)

  • 해당 주소로 GET으로 보내주셔야 합니다. 보내는 파라미터 값은 "tr_no" 값을 보내주시면 됩니다.
    (tr_no : Pay2Pay에서 부여한 고유거래번호)
결제내역 확인

- 해당 PG사 관리자 화면에서 처리