결제URL 발송 API

결제URL 발송 사용 시 주의사항

결제요청한 URL는 결제완료 이후에는 재사용 할 수 없습니다(1회만 사용)
발송수단 : SMS,이메일,카카오 (1개만 선택)

결제URL 발송 요청전문

기본도메인(요청도메인)

라이브 : https://www.cookiepayments.com [POST] 
테스트 : https://sandbox.cookiepayments.com [POST] 

URL

{요청도메인}/urlpay/request [POST]

CURL

샘플 예제

curl -H "Content-Type: application/json" \
     -H "ApiKey": "COOKIEPAY에서 발급받은 연동키" \
     -d '{ "API_ID": "COOKIEPAY에서 발급받은 가맹점연동 ID", \
           "PRODUCTNAME": "상품명", \
           "AMOUNT": "결제금액", \
           "BUYERNAME": "고객명", \
           "BUYERHP": "고객 휴대폰번호", \
           "BUYEREMAIL":"고객 E-MAIL", \
           "REQ_TYPE":"발송타입", \

        }' \
    -X POST "{요청도메인}/urlpay/request"

PHP

샘플 예제

$headers = array(); 

array_push($headers, "content-type: application/json; charset=utf-8");
array_push($headers, "ApiKey: COOKIEPAY에서 발급받은 연동키 ");

$cookiepayments_url = "{요청도메인}/urlpay/request";

$request_data_array = array(
    'API_ID' => 'COOKIEPAY에서 발급받은 가맹점연동 ID',
    'PRODUCTNAME'=> '상품명',
    'AMOUNT'=> '결제금액',
    'BUYERNAME'=> '고객명',
    'BUYERHP'=> '고객 휴대폰번호',
    'BUYEREMAIL'=> '고객 E-MAIL',
    'REQ_TYPE'=>  '발송타입',
);

$cookiepayments_json = json_encode($request_data_array, TRUE);

$ch = curl_init(); // curl 초기화

curl_setopt($ch,CURLOPT_URL, $cookiepayments_url);
curl_setopt($ch,CURLOPT_POST, false);
curl_setopt($ch,CURLOPT_POSTFIELDS, $cookiepayments_json);
curl_setopt($ch,CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch,CURLOPT_CONNECTTIMEOUT ,3);
curl_setopt($ch,CURLOPT_TIMEOUT, 20);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$response = curl_exec($ch);
curl_close($ch);

var_dump($response);

요청 전문 파라미터

결제URL 발송 응답전문

응답 전문 파라미터

결제URL 통지 전문

통지 전문 파라미터

통지 전문(Noti)은 JSON POST 형식으로 전송됩니다.

결제URL 통지 전문(Noti)은 결제승인 파라미터에 대하여 쿠키페이먼트에서 고객사로 Server To Server로 전송됩니다.
개발한 통지 URL 입력방법 : 쿠키페이먼츠 접속 후 > API 연동 메뉴 > PG사 조회 및 연동 설정 > PG 연동 버튼 클릭 > 통지 URL 입력란에 입력 후 설정 저장하시면 됩니다.

결제승인 전문 파라미터

결제URL 발송 결제정보 확인

결제URL 발송 결제정보 확인

URL 결제 생성 후 고객이 결제를 하였는지 확인 하는 API 입니다. 고객님이 결제를 정상적으로 하였다면 결제 데이터를 리턴해주며, 결제가 실행 안된 경우에는 결제가 이루어지지 않았다는 데이터를 리턴해줍니다.

TOKEN 발행 URL

{요청도메인}/payAuth/token [POST]

TOKEN 요청 전문 파라미터

결제URL 발송 결제정보 확인 URL

{요청도메인}/api/urlcert [POST]

결제URL 발송 결제정보 확인 요청 전문 파라미터

CURL

/* 토큰 발급 API */
curl -H "Content-Type: application/json" \
     -d '{"pay2_id": "cookiepayments에서 발급받은 ID", \
          "pay2_key": "cookiepayments에서 발급받은 연동키" \
         }' \
     -X POST "{요청도메인}/payAuth/token"

/* 발급 받은 TOKEN으로 결제 취소 API 통신 */
curl -H "Content-Type: application/json" \
     -H "TOKEN: TOKEN API통해 발행된 TOKEN 값" \
     -d '{"URLKEY": "생성된 결제창 URL KEY"}' \
     -X POST "{요청도메인}/api/urlcert"

PHP

/* 토큰 발행 API */
$tokenheaders = array();

array_push($tokenheaders, "content-type: application/json; charset=utf-8");

$token_url = "{요청도메인}/payAuth/token";

$token_request_data = array(
    'pay2_id' => 'cookiepayments에서 발급받은 ID',
    'pay2_key'=> 'cookiepayments에서 발급받은 연동키',
);

$req_json = json_encode($token_request_data, TRUE);

$ch = curl_init(); // curl 초기화

curl_setopt($ch,CURLOPT_URL, $token_url);
curl_setopt($ch,CURLOPT_POST, false);
curl_setopt($ch,CURLOPT_POSTFIELDS, $req_json);
curl_setopt($ch,CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch,CURLOPT_CONNECTTIMEOUT ,3);
curl_setopt($ch,CURLOPT_TIMEOUT, 20);
curl_setopt($ch, CURLOPT_HTTPHEADER, $tokenheaders);
$RES_STR = curl_exec($ch);
curl_close($ch);
$RES_STR = json_decode($RES_STR,TRUE);
/* 여기 까지 */

if($RES_STR['RTN_CD'] == '0000'){

    $headers = array(); 
    array_push($headers, "content-type: application/json; charset=utf-8");
    array_push($headers, "TOKEN: TOKEN API통해 발행된 TOKEN 값");

    $cookiepayments_url = "{요청도메인}/api/urlcert";

    $request_data_array = array(
        'URLKEY' => '생성된 결제창 URL KEY',

    );

    $cookiepayments_json = json_encode($request_data_array, TRUE);

    $ch = curl_init(); // curl 초기화

    curl_setopt($ch,CURLOPT_URL, $cookiepayments_url);
    curl_setopt($ch,CURLOPT_POST, false);
    curl_setopt($ch,CURLOPT_POSTFIELDS, $cookiepayments_json);
    curl_setopt($ch,CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch,CURLOPT_CONNECTTIMEOUT ,3);
    curl_setopt($ch,CURLOPT_TIMEOUT, 20);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    $response = curl_exec($ch);
    curl_close($ch);

    var_dump($response);
}

결제URL 발송 결제정보 응답 전문 파라미터