빠른 시작

핵심 사항

• 가맹점 계정을 등록하고 kuko_test_ 키를 발급받아 X-Api-Key 헤더에 넣으세요.
• payment.succeeded, payment.failed, payment.expired를 구독하는 공개 HTTPS 샌드박스 Webhook을 설정하세요. 아직 주소가 없다면 주문과 이벤트 조회부터 시작할 수 있습니다.
• 고유한 out_trade_no, 정수 amount, currency로 POST /v1/orders를 호출하고 구매자를 checkout_url로 이동시키세요. URL의 token을 로그에 남기지 마세요.
• 원본 요청 본문으로 Webhook 서명을 검증하고 이벤트 ID로 중복 처리하세요. 알림이 늦으면 주문을 조회하세요.
• 운영 결제에는 가맹점 승인 후 kuko_live_ 키와 운영 Webhook을 설정하거나 공개 HTTPS notify_url을 전달하세요.

예시

curl -X POST "https://api.kukopay.com/v1/orders" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: $KUKOPAY_API_KEY" \
  -d '{"out_trade_no":"ORD_20260921_0001","amount":2990,"currency":"USD","subject":"Test order"}'