테스트·시크릿

1테스트 이벤트 발송

설정한 URL 로 더미 이벤트를 1건 보내요. 실제 이벤트와 같은 경로​(큐·서명·재시도)를 타기 때문에 연동 전체를 검증할 수 있어요.

코드 예제

curl -X POST "https://message.bootapi.com/alimtalk/webhook/test" \
  -H "Authorization: Basic {base64(client_key:secret_key)}"bash

require 'bootpay'

commerce = BootpayStore::RestClient.new(client_key: 'your-commerce-client-key', secret_key: 'your-commerce-secret-key')
response = commerce.alimtalk_webhook_test
puts response.dataruby

응답

{
  "delivery_id": "68b0f2a1c3d4e5f6a7b8c9e1",
  "url": "https://example.com/hooks/alimtalk",
  "queued": true
}json

delivery_id 로 전송 이력에서 결과를 확인할 수 있어요. payload 는 발송 성공(301) 이벤트 모양의 더미 카드이고 tags 에 test 가 들어 있어요. 실제 카드와 달리 created_at 이 없으니, 파서가 이 필드를 필수로 보면 테스트에서만 실패할 수 있어요.

2서명 시크릿 재발급

코드 예제

curl -X POST "https://message.bootapi.com/alimtalk/webhook/secret" \
  -H "Authorization: Basic {base64(client_key:secret_key)}"bash

response = commerce.alimtalk_webhook_rotate_secret
puts response.data[:secret]ruby

응답

{
  "configured": true,
  "url": "https://example.com/hooks/alimtalk",
  "events": [301, 302, 303, 310, 311],
  "enabled": true,
  "secret": "whsec_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b",
  "last_sent_at": "2026-08-27T10:00:05+09:00",
  "last_status": 200,
  "consecutive_failures": 0,
  "auto_disabled_at": null,
  "retry_count": 10
}json

시각 필드 형식은 응답의 시각 형식을 봐요.

에러 코드