결제/환불 API
📘 개발 가이드
결제/환불 API
파트너사에서 결제 또는 환불을 처리한 경우, 해당 정보를 Callback API를 통해 메이크샵에 전달해야 합니다. 전달이 완료되어야 상점의 앱 결제 내역 및 만료일이 갱신되어 상점에서 계속 사용이 가능합니다.
액세스 토큰 필요
모든 Callback API 요청 시 액세스 토큰 발급 후 Authorization 헤더에 포함하여 전달해야 합니다.
payment — 결제 완료 전달
| 항목 | 내용 |
|---|---|
| Method | POST |
| URL | https://connect.makeshop.co.kr/api/application/:shopId/callback/payment |
| Format | application/json |
Path Parameter
| Parameter | Required | Description |
|---|---|---|
shopId | 필수 | 요청한 상점 ID |
Request Body
{
"client_id": "fc2fd410-6d35-4738-b39f-9fdccd123456",
"partner_order_uid": "test-111-222-333",
"amount": 15000,
"payment_method": "CARD",
"expired_at": "20270319"
}
| Parameter | Required | Description |
|---|---|---|
client_id | 필수 | 결제 진행한 App Client ID |
partner_order_uid | 필수 | 파트너사의 주문 고유 번호 |
amount | 필수 | 결제 금액 |
payment_method | 필수 | 결제 수단, 영문 코드 형태 ( CARD - 신용카드, TRANSFER - 계좌이체, VIRTUAL_ACCOUNT - 가상계좌, PHONE - 휴대폰, FREE - 무료) |
expired_at | - | 적용할 만료일 (YYYYMMDD 형식). 결제/환불 관계없이 파트너사가 보낸 값이 앱 설치 만료일로 강제 덮어쓰기 됩니다. |
주의
Access Token 발급 시 사용한 client_id와 shopId를 동일하게 입력해야 합니다. 다른 값을 입력할 경우 올바른 설치 정보를 조회할 수 없습니다.
Response
성공 시 HTTP 201을 반환합니다.
refund — 환불 완료 전달
| 항목 | 내용 |
|---|---|
| Method | POST |
| URL | https://connect.makeshop.co.kr/api/application/:shopId/callback/refund |
| Format | application/json |
Path Parameter
| Parameter | Required | Description |
|---|---|---|
shopId | 필수 | 요청한 상점 ID |
Request Body
{
"client_id": "fc2fd410-6d35-4738-b39f-9fdccd123456",
"partner_order_uid": "test-111-222-333",
"amount": 15000,
"payment_method": "CARD",
"refund_reason": "더이상 사용하지 않습니다.",
"expired_at": "20270319"
}
| Parameter | Required | Description |
|---|---|---|
client_id | 필수 | 결제 진행한 App Client ID |
partner_order_uid | 필수 | 파트너사의 주문 고유 번호 |
amount | 필수 | 환불 금액 |
payment_method | 필수 | 환불 수단, 영문 코드 형태 ( CARD - 신용카드, TRANSFER - 계좌이체, VIRTUAL_ACCOUNT - 가상계좌, PHONE - 휴대폰, FREE - 무료) |
refund_reason | - | 환불 사유 |
expired_at | - | 적용할 만료일 (YYYYMMDD 형식). 결제/환불 관계없이 파트너사가 보낸 값이 앱 설치 만료일로 강제 덮어쓰기 됩니다. |
주의
Access Token 발급 시 사용한 client_id와 shopId를 동일하게 입력해야 합니다. 다른 값을 입력할 경우 올바른 설치 정보를 조회할 수 없습니다.
Response
성공 시 HTTP 201을 반환합니다.