---
title: "배송정보 단건등록 API"
method: POST
path: "/escrows/logis/{imp_uid}"
tags: ["escrow.logis"]
---

# 배송정보 단건등록 API

`POST /escrows/logis/{imp_uid}`

에스크로 결제 건에 대한 배송정보 등록(2-depth의 json으로 Request Body가 구성되어야 합니다)<br><br>
     logis는 하위 필드가 모두 필수입니다.<br>sender, receiver의 각 세부 항목은 PG사마다 필수 여부가 모두 다릅니다.<br><br>
     <h4>지원되는 PG사</h4><ul> <li>KG이니시스</li> <li>NHN KCP</li> <li>키움페이(구 다우, 페이조아)(다우테이타)</li> <li>KSNET</li>  <li>스마트로 - 신모듈(PG사와의 사전 계약이 반드시 필요합니다.)</li><li>(신) 나이스페이</li><li>웰컴페이먼츠</li></ul>

## Path parameters

- `imp_uid` string, required

## Response `200`

등록 완료

- EscrowLogisResponse — 등록된 에스크로 배송 정보. 바로 아래 EscrowLogis structure를 확인하세요
  - `code` integer — 0이면 정상적인 조회, 0아닌 값이면 message를 확인해봐야 합니다
  - `message` string — code값이 0이 아닐 때, '존재하지 않는 결제정보입니다'와 같은 오류 메세지를 포함합니다
  - `response` EscrowLogisAnnotation
    - `company` string, required — 택배사코드
    - `invoice` string, required — 송장번호
    - `sent_at` integer, required — 발송일시 UNIX TIMESTAMP
    - `applied_at` integer, required — 배송정보 등록일시 UNIX TIMESTAMP

## Other responses

- `400` — 필수 파라메터가 누락되거나 (PG사별로 필수 여부가 다를 수 있음), 지원하는 않는 PG사인 경우
- `401` — 인증 Token이 전달되지 않았거나 유효하지 않은 경우
- `404` — 배송정보를 등록할 거래건이 존재하지 않음
- `405` — POST요청이 아닌 경우
- `409` — 이미 배송정보 등록이 완료됨, 해당거래건은 배송정보를 등록할 수 없는경우
- `500` — 배송정보 등록 도중 오류 발생

---

[API](https://skmtc.net/iamport/apis/rest-api.md) · [All operations](https://skmtc.net/iamport/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iamport/rest-api/revisions/006dfffdec43/schema)