---
title: "결제 상태 동기화"
method: POST
path: "/{파트너사가 제공하는 callbackUrl}"
tags: ["erp-callback-controller"]
---

# 결제 상태 동기화

`POST /{파트너사가 제공하는 callbackUrl}`

## Request

- The document declares no server URL.
- Auth: none declared

청구서를 통한 결제가 완료되면 페이민트 -> 파트너사에게 결제 상태를 전달합니다.  
파트너사는 해당 URL로 결제 상태를 수신하여 자사 시스템에 반영합니다.  
파트너사는 페이민트를 통해 결과를 수신할 수 있도록 REST api 형태로 URL을 전달해야합니다.  

아래의 필드들을 토대로 페이민트가 호출할 수 있도록 개발 후 수신 응답을 response 양식에 맞춰 개발해야 합니다.  
response 성공 예제 데이터가 동일한 양식으로 데이터가 오지 않거나 응답 오류가 발생할 경우 페이민트는 24시간동안 매시간마다 동기화를 재시도합니다.

## Request body

- ErpCallbackVO
  - `apikey` string, required: 파트너 연동을 위한 고유키
  - `bill_id` string, required: 청구서 ID 문자/숫자 20자리 (중복불가) -개발: 사업자번호 + 10자리 자유롭게 사용 -운영: 20자리 자유롭게 사용
  - `appr_card_type` string: 결제카드종류
  - `appr_pay_type` string: 결제수단코드
  - `appr_dt` string: 승인일시
  - `appr_origin_dt` string: 원거래 승인일시
  - `appr_price` string: 승인금액
  - `appr_num` string: 승인번호
  - `appr_origin_num` string: 원거래승인번호
  - `appr_state` string, required: 결제 상태 F:결제완료, W:미결제, C:취소, D:파기
  - `appr_issuer` string: 결제은행 / 카드명
  - `appr_issuer_cd` string: 발행카드코드/은행코드
  - `appr_issuer_num` string: 결제카드 / 계좌번호
  - `appr_acquirer_cd` string: 매입사코드
  - `appr_acquirer_nm` string: 매입사명
  - `appr_res_cd` string: 응답코드
  - `appr_monthly` string: 결제시 할부개월수
  - `appr_cash_num` string: 현금영수증 발급 승인번호
  - `appr_cash_trader` string: 현금영수증 발급 구분 개인:0, 사업자:1
  - `appr_cash_issuance_number` string: 현금영수증 발급 요청 번호 -현금영수증 발급 시 사용 -자진발급시 "0100001234"

## Response `200`

성공

- Base
  - `code` string: 응답 코드
  - `msg` string: 응답 메세지

---

[API](https://skmtc.dev/payssam/apis/payssam-api.md) - [All operations](https://skmtc.dev/payssam/apis/payssam-api/llms.txt) - [OpenAPI document](https://skmtc.dev/payssam/apis/payssam-api/revisions/73517f9ba4e2?raw)