핵심 사항
- 포털의 개발자 → 이지페이 연동에서 활성화하세요. 게이트웨이는 https://api.kukopay.com/epay이며, 숫자 pid가 샌드박스/운영을 결정하고 환경마다 32자리 키가 있습니다.
- submit.php(브라우저 이동)와 mapi.php(서버 호출, payurl 반환)는 일반 KukoPay 주문을 만들고, api.php?act=order로 조회합니다. 같은 out_trade_no는 같은 주문을 반환합니다.
- 서명은 참조 SDK와 같습니다. sign, sign_type, 빈 값을 빼고 이름순으로 정렬해 URL 인코딩 없이 k=v&k=v로 이은 뒤 키를 붙여 MD5(소문자)를 구합니다.
- money는 통화 없는 소수이며 포털에서 고른 통화로 청구됩니다. 소수점은 두 자리까지입니다.
- 결제 성공만 알립니다. notify_url로 trade_status=TRADE_SUCCESS가 담긴 서명된 GET을 보냅니다. 본문 success를 반환하지 않으면 재시도하며 최대 총 6회 보냅니다.
- 이지페이 주문도 일반 주문입니다. 환불, 차지백, 출금이 그대로 동작하며 이후 이벤트는 Webhook 엔드포인트에도 전달됩니다.
- 주문 유효 시간(기본 30분)은 연동 시스템 자체의 주문 만료 시간보다 길지 않게 설정하세요. 그렇지 않으면 이미 취소된 주문에 결제될 수 있습니다.
예시
json
{
"code": 1,
"msg": "success",
"trade_no": "TRD_SB_9F3A…",
"payurl": "https://checkout.kukopay.com/checkout?trade_no=TRD_SB_9F3A…&token=…",
"request_id": "req_…"
}