PAYCO Developer

1. 페이코 게임 간편결제 정책

• 결제환경
  • - 페이코 간편결제는 Web/App을 모두 지원하는 서비스이지만 리스크 최소화를 위해 게임에서는 App에서만 결제지원 합니다.
• 한도정책
  • - 게임사별 건별 한도 10만원 / 월50만원 한도로 적용
  • -> 일부 카드사는 카드사의 정책에따라 예외가 있을 수 있으나 장기적으로 모든 카드 건별 10만원 / 월50만원으로 적용 예정입니다
• 인증정책
  • - 페이코 간편결제 + ARS 인증 -> 향후 ARS 인증에 대해 더 간편한 형태로 개선할 예정입니다
• 페이코 OnLINE FDS 적용
  • - 한게임 운영을 통한 FDS운영경험, 사용자 실시간 리뷰, 스미싱/파밍 등 Fraud대응 노하우, 서비스기반의 행동패턴 분석체계
• 서비스 확대범위
  • - 현재는 신용카드 간편결제만 제공, 향후 휴대폰/계좌/티머니/페이코포인트 적용을 준비하고 있음

2. 페이코 게임 간편결제 흐름

1) 게임 - PAYCO 앱 결제 플로우

• 

2) 게임 - PAYCO 앱 결제 프로세스

• 

• 

3. 페이코 게임 간편결제 연동

▶ 연동 키 값 설정 (sellerKey, cpId, productId )

3-1. 주문 예약(payco_reserve)

• 간편결제 주문서를 띄우기 전에 주문예약 API를 통해 필요한 정보를 전달합니다.
• 가맹점에서는 주문 예약 응답으로 받은 주문서 URL 을 팝업으로 띄웁니다.
• 외부가맹점의 주문번호(sellerOrderReferenceKey)는 중복되지 않는 고유한 key이어야 합니다.
• 외부가맹점에서 관리하는 주문상품 연동 키(sellerOrderProductReferenceKey)는 주문 별로 고유한 key이어야 합니다.
• PAYCO 주문예약 후 결제팝업 오픈시 팝업차단을 위한 개발 TIP!!
  • - orderSheetUrl로 PAYCO 팝업오픈시엔
  • 가맹점페이지 오픈 후 피드백받은 orderSheetUrl을 redirect처리하도록 합니다.
  • -팝업 오픈은 POST방식의 submit은 지양하도록 한다. ( IE11 관리자모드 about:blank 새창 오픈 )
• METHOD : POST
• URL : /outseller/order/reserve

주문 예약 API > INPUT

▷ 19번 컬럼 orderProducts 주문상품 List

▷ 20번 컬럼 extraData

▷ 20번 컬럼 extraData의 viewOptions 화면UI 옵션

▷ 21번 컬럼 sellerOptions(판매자 부가정보) 설정 - Json 형태의 String

				
{
  "sellerKey": "GTXYJV",
  "payMode": "PAY2",
  "orderProducts": [{
      	"productImageUrl": "",
	  	"orderConfirmMobileUrl": "",
		"productId": "GAME_GTXYJV_EASYP",
		"productPaymentAmt": 11000,
		"productAmt": 11000,
		"cpId": "GAME_GTXYJV",
		"sortOrdering": 1,
		"orderQuantity": 1,
		"productName": "[PAYCO 게임] 프리미엄 패키지",
		"orderConfirmUrl": "",
		"taxationType": "TAXATION",
		"sellerOrderProductReferenceKey": "ITEM_100001",
		"option": ""
  }],
  "totalTaxableAmt": 10000,
  "totalTaxfreeAmt": 0,
  "totalVatAmt": 1000,
  "totalPaymentAmt": 11000,
  "orderChannel": "PC",
  "sellerOrderReferenceKey": "TEST329710910399",
  "orderMethod": "EASYPAY",
  "individualCustomNoInputYn": "N",
  "sellerOptions": "{\"clientIp\":\"125.7.198.4\",\"memberId\":\"payco1234\"}",
  
  ....... 생략
  
}
				
				

주문 예약 API > OUTPUT

				
{ 
  "result":{ 
    "reserveOrderNo": "201703222004466453",	
    "orderSheetUrl":"https://alpha-
                     bill.payco.com/app/bridgeLogin
		       /D8DD85C4CD3E413D31ADBDE0696A2D9C
		       9747165D69DCA1982744F33924A8A200" 
  }, 
	
  "code": 0, 
  "message": "success"
}
				
				

3-2. 결제인증 완료(payco_return)

• 주문예약 API 연동 시 파라미터로 'returnUrl'을 전달하게 됩니다.
• 'returnUrl'은 결제인증완료URL로 외부가맹점이 제공하는 페이지입니다.
• 결제인증 성공시점 또는 사용자취소시 외부가맹점의 returnUrl로 이동합니다.
• 캐릭터셋은 UTF-8이며, GET로 전달합니다. (option POST)
• 예약시 returnUrlParam 값에 셋팅된 정보가 존재시 해당값을 추가하여 returnUrl을 호출합니다.
• 예] 예약API 호출시 전달된 정보
  • - "returnUrl": "https://alpha-api-bill.payco.com/test/surl/ok"
  • - "returnUrlParam" : "{\"returnUrlParam1\":\"data1\", \"returnUrlParam2\":300}"
• 예] 결제인증완료 호출 페이지
  • - http://alpha-api-bill.payco.com/test/surl/ok?returnParam1=data1&returnParam2=300
• 자세한 항목은 아래 'returnUrl 로 전달되는 정보'를 참고합니다.
• returnUrl에서는 결제팝업창을 close한 다음 주문이 가능할 경우 결제승인처리API를 호출하여 주문이 완료 (결제완료) 될 수 있도록 합니다.
• 가맹점에서는 총 결제금액 (totalPaymentAmt)과 외부가맹점번호가 일치하는지 확인합니다.

returnUrl 로 전달되는 정보

3-3. 결제승인 요청(payco_return)

• 결제인증 후 실제 결제완료 처리가 되는 API 입니다.
• 외부가맹점에서 주문 가능한 조건이 되는 경우 결제승인 API를 호출합니다. ( ex. 재고확인 )
• 승인처리 성공시 PAYCO 회원에게 PAYCO앱에 주문완료 push알림 및 email을 발송합니다.
• 결제인증 후 5분내 승인처리가 이루어져야 합니다.
• 중복 승인 요청이 일어나지 않도록 방어코드 작성 필요합니다.
• timeout 최대 30초 설정
• URL : /outseller/payment/approval
• totalOrderAmt(총 주문금액) + totalDeliveryFeeAmt(총 배송비) + totalRemoteAreaDeliveryFeeAmt(총 도서산간비용)
  = 총 결제금액 (totalPaymentAmt)

결제승인 API > INPUT

				
{
    "sellerKey" : "GTXYJV", 
    "reserveOrderNo" : "201703222004466453",
    "sellerOrderReferenceKey": "TEST329710910399", 
    "paymentCertifyToken" : "BARJT6MVGuyXmf/Gd5_75fba6omtUMNCnW2kv1nocMmT4eNQ_FNwsh8995zDHQNe",
    "totalPaymentAmt": 11000 
}
				
				

결제승인 API > OUTPUT

▷ orderProducts (주문상품List)

▷ paymentDetails (결제내역 List)

▷ cardSettleInfo (카드결제정보)

▷ cellphoneSettleInfo(핸드폰 결제 정보)

▷ realtimeAccountTransferSettleInfo(실시간계좌이체 결제정보)

▷ nonBankbookSettleInfo (무통장입금 결제정보)

▷ couponSettleInfo (쿠폰정보)

				
{
	"result": {
		"sellerOrderReferenceKey": "TEST329710910399",
		"reserveOrderNo": "201703222004466453",
		"orderNo": "201703222002237177",
		"memberName": "강**",
		"memberEmail": "na****",
		"orderChannel": "MOBILE",
		"totalOrderAmt": 11000,
		"totalDeliveryFeeAmt": 0,
		"totalRemoteAreaDeliveryFeeAmt": 0,
		"totalPaymentAmt": 11000,
		"orderProducts": [{
			"orderProductNo": "201703222002391601",
			"sellerOrderProductReferenceKey": "ITEM_100001",
			"orderProductStatusCode": "OPSPAED",
			"orderProductStatusName": "결제완료",
			"cpId": "GAME_GTXYJV",
			"productId": "GAME_GTXYJV_EASYP",
			"productKindCode": "GENERAL_PRODUCT",
			"productPaymentAmt": 11000,
			"originalProductPaymentAmt": 11000
		}],
		"paymentDetails": [{
			"couponSettleInfo": {
				"discountAmt": 2000.0,
				"discountConditionAmt": 7000.0,
				"encCouponId": null
			},
			"paymentTradeNo": "201703222002899033",
			"paymentMethodCode": "75",
			"paymentMethodName": "페이코 쿠폰",
			"paymentAmt": 2000,
			"tradeYmdt": "20170322145004",
			"pgAdmissionNo": "29701",
			"pgAdmissionYmdt": "20170322145004",
			"easyPaymentYn": "N"
		}, {
			"cardSettleInfo": {
				"cardCompanyName": "삼성카드",
				"cardCompanyCode": "CCSS",
				"cardNo": "941010******2222",
				"cardInstallmentMonthNumber": "00",
				"cardAdmissionNo": "90766383",
				"cardInterestFreeYn": "N",
				"corporateCardYn": "N",
				"partCancelPossibleYn": "Y"
			},
			"paymentTradeNo": "201703222002899030",
			"paymentMethodCode": "31",
			"paymentMethodName": "신용카드",
			"paymentAmt": 9000,
			"tradeYmdt": "20170322145004",
			"pgAdmissionNo": "17711901919006",
			"pgAdmissionYmdt": "20170322145004",
			"easyPaymentYn": "Y"
		}],
		"orderCertifyKey": "Rzt4FUV7twAWe5cnhuCcKLYp4AAHz4yxgZ49znjVEnG4CC",
		"paymentCompletionYn": "Y",
		"paymentCompleteYmdt": "20170322145004"
	},
	"code": 0,
	"message": "success"
}
				
				

3-4. 주문결제 취소 처리(payco_cancel)

• 기존에 생성된 주문 및 결제내역을 취소 처리하는 경우 사용합니다.
• PG취소가 가능한 금액으로 요청 했을 때만 취소됩니다.
• METHOD : POST
• URL : /outseller/order/cancel

주문 결제 취소 처리 API > INPUT

▷ orderProducts

				
{
    "sellerKey" : "GTXYJV", 
    "orderNo" :	"201703222002237177", 
    "cancelTotalAmt" : 11000, 
    "orderCertifyKey" : "Rzt4FUV7twAWe5cnhuCcKLYp4AAHz4yxgZ49znjVEnG4CC",
    "orderProducts" : [ 
        { 
            "sellerOrderProductReferenceKey" : "ITEM_100001", 
            "cpId" : "GAME_GTXYJV", 
            "productId" : "GAME_GTXYJV_EASYP", 
            "productAmt" : 11000, 
            "cancelDetailContent" : "TEST" 
        } 
    ] 
}
				
				

▷ 주문 결제 취소 처리 API > OUTPUT

▷ cancelPaymentDetails

				
{ 
    "result": { 
        "orderNo": "201703222002237177", 
        "cancelTradeSeq": 2000000270, 
        "totalCancelPaymentAmt": 11000, 
        "remainCancelPossibleAmt": 0, 
        "cancelPaymentDetails": [ 
            { 
                "paymentTradeNo": "201703262000003384", 
                "paymentMethodCode": "98", 
                "cancelPaymentAmt": 40000, 
                "tradeYmdt": "20141226152604" 
            } 
        ] 
        "cancelYmdt": "20151019172418"
    }, 
    "message": "success", 
    "code": 0 
}