카카오모빌리티가 파트너사로 보내는 콜백으로 주문과 배송 상태 변경 정보를 파트너사에 전달합니다. 콜백은 다음 정보를 포함합니다.
이후 호스팅사가 카카오에 응답하는 HTTP 상태 코드를 확인하여 주문 또는 배송 상태 변경을 마무리합니다. 콜백 URL은 시작하기 전에 단계에서 설정한 호스트 URL를 사용합니다.
POST 방식표 1 | 파라미터
| Name | Type | Description | Required |
|---|---|---|---|
order_id |
String | 주문 아이디 | 필수 |
event |
String | 주문 상태 |
다음 중 하나:
matched: 배송원 배정 완료
canceled: 배송 취소
pickup_completed: 배송원 픽업 완료
completed: 배송 완료
matching_failed: 배송원 배정 실패
aborted: 관리자 강제 종료
| 필수 |
| pickerId | String | 배송원 아이디로 배송원 정보를 담고 있음
event 값이 다음 중 하나로 설정될 때 전달됨:
matched: 배송원 배정 완료
pickup_completed: 배송원 픽업 완료
completed: 배송 완료 | 선택 |
| reason | String | 주문 취소 이유로 event 값이 canceled로 설정될 때 전달됨 | 선택 |
| cancelBy | String | 주문 취소 주체로 event 값이 canceled로 설정될 때 전달됨
다음 중 하나:
admin: 관리자에 의한 주문 취소
picker: 배송원에 의한 주문 취소
user: 사용자에 의한 주문 취소 | 선택 |