> For the complete documentation index, see [llms.txt](https://a-send.gitbook.io/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://a-send.gitbook.io/api/changelog/change-log.md).

# Changelog

에이샌드 API의 변경이력을 기록합니다.

{% updates format="full" %}
{% update date="2026-08-13" %}

## v1.3.3

구독·결제수단 관리와 결제 내역 조회 API가 추가되었습니다.

### \[변경사항]

**구독**

* <mark style="color:$primary;">`Add`</mark> 구독 상태 조회 ( /v1/subscription/status )
* <mark style="color:$primary;">`Add`</mark> 플랜 목록 조회 ( /v1/subscription/plans )
* <mark style="color:$primary;">`Add`</mark> 구독 신청 ( /v1/subscription/subscribe )
* <mark style="color:$primary;">`Add`</mark> 구독 해지 요청 ( /v1/subscription/cancel )
* <mark style="color:$primary;">`Add`</mark> 해지 예약 취소 ( /v1/subscription/cancel/undo )
* <mark style="color:$primary;">`Add`</mark> 구독 변경 예약 ( /v1/subscription/schedule-change )
* <mark style="color:$primary;">`Add`</mark> 구독 변경 예약 취소 ( /v1/subscription/schedule-change/undo )

**결제수단**

* <mark style="color:$primary;">`Add`</mark> 결제수단(카드) 목록 조회 ( /v1/payment-method/list )
* <mark style="color:$primary;">`Add`</mark> 결제수단(카드) 삭제 ( /v1/payment-method/delete ) *결제*
* <mark style="color:$primary;">`Add`</mark> 결제 내역 조회 ( /v1/pay/history ) *템플릿*
* <mark style="color:$warning;">`Update`</mark> 템플릿 목록 응답에 jcode 와is\_shared 필드 추가 ( /v1/template/list )

### \[기타]

* 구독은 카드 자동결제 전용입니다.

  선불(충전형) 구독은 API로 제공하지 않습니다.
* 유료 플랜 구독 신청 시 미리 등록된 카드(빌링키)로 즉시 자동결제됩니다.

  카드가 없으면 먼저 등록해야 합니다.
* 카드 등록은 카드번호를 API로 받지 않고, 결제창(빌링키 세션 · /v1/pay/session purpose=billing\_key)에서만 처리합니다.
* 결제수단 응답에는 빌링키 원문이 포함되지 않으며, 카드번호는 마스킹되어 반환됩니다.
* 결제 내역·구독 응답에도 카드/빌링키 등 민감 정보는 포함되지 않습니다.
  {% endupdate %}

{% update date="2026-08-01" %}

## v1.3.2

결제 JS SDK 가 추가되었습니다.

### \[변경사항]

**결제**

* <mark style="color:$primary;">`Add`</mark> 결제 JS SDK 제공 ( /sdk/v1/pay.js?key={SDK\_KEY} )
* <mark style="color:$warning;">`Update`</mark> 결제 세션 발급 응답에 `sdk_key` 추가 ( /v1/pay/session )

### \[기타]

* SDK 는 모달(iframe) 결제 화면을 표시하며, 모바일에서는 팝업으로 자동 전환됩니다.
* `SDK_KEY`는 API 키와 분리된 공개 키(`pk_` 접두사)로, HTML에 노출해도 무해합니다.
* 결제 화면 iframe 임베드는 채널에 등록된 사이트 origin에서만 허용됩니다.
  {% endupdate %}

{% update date="2026-08-01" %}

## v1.3.1

API 가 추가되었습니다.

### \[변경사항]

**템플릿**

* <mark style="color:$primary;">`Add`</mark> 알림톡 템플릿 카테고리 목록 조회 ( /v1/template/categories )

**포인트**

* <mark style="color:$primary;">`Add`</mark> 계정 매체별 발송요금 조회 ( /v1/point/prices )

### \[기타]

* 템플릿 등록/수정의 `category` 필드에 사용할 코드는 알림톡 템플릿 카테고리 목록 조회에서 확인할 수 있습니다.
* 발송요금은 계정에 개별 단가가 설정된 경우 해당 단가가, 없으면 현재 플랜의 기본 단가가 반환됩니다.
  {% endupdate %}

{% update date="2026-07-27" %}

## v1.3.0

외부 연동으로 채널 등록, 템플릿 관리, 결제까지 처리할 수 있도록 API 가 추가되었습니다.

### \[변경사항]

**메시지**

* <mark style="color:$primary;">`Add`</mark> 알림톡 배치 발송 ( /v1/message/send/alimtalk/batch )
* <mark style="color:$warning;">`Update`</mark> 알림톡 발송 예약 발송 지원 — `scheduled_at` 파라미터 추가 ( /v1/message/send/alimtalk ) *채널*
* <mark style="color:$primary;">`Add`</mark> 카카오 채널 카테고리 목록 조회 ( /v1/channel/categories )

**채널**

* <mark style="color:$primary;">`Add`</mark> 등록 인증번호 발송 ( /v1/channel/register/request )
* <mark style="color:$primary;">`Add`</mark> 알림톡 채널 등록 ( /v1/channel/register/confirm )

**템플릿**

* <mark style="color:$primary;">`Add`</mark> 템플릿 등록 ( /v1/template/create )
* <mark style="color:$primary;">`Add`</mark> 템플릿 수정 ( /v1/template/update )
* <mark style="color:$primary;">`Add`</mark> 템플릿 삭제 ( /v1/template/delete )
* <mark style="color:$primary;">`Add`</mark> 템플릿 검수 요청 ( /v1/template/request-inspection )
* <mark style="color:$primary;">`Add`</mark> 템플릿 검수 요청 취소 ( /v1/template/cancel-inspection )

**결제**

* <mark style="color:$primary;">`Add`</mark> 결제 세션 발급 ( /v1/pay/session )

### \[기타]

* 알림톡 배치 발송은 한 번의 요청으로 최대 100건까지 접수되며, 요청 제한(1분당 60회)은 배치 1회를 요청 1회로 계산합니다.
* 템플릿 이미지는 base64 인라인(`templateImageBase64` / `highlightImageBase64`)으로 전달합니다. (multipart 미지원)
* 결제 세션은 발급 후 10분간 유효한 1회용 팝업 URL 이며, 결제 결과는 `postMessage` 로 전달됩니다.
* 채널·템플릿 등록에는 플랜별 한도가 적용됩니다.
  {% endupdate %}

{% update date="2026-03-14" %}

## v1.2.0

웹훅 관련 API가 추가되었습니다.

#### \[변경사항]

**웹훅**

* <mark style="color:$primary;">`Add`</mark> 웹훅 수신 ( /webhook/r/{code} )
* <mark style="color:$primary;">`Add`</mark> 웹훅 목록 조회 ( /v1/webhook/list )
* <mark style="color:$primary;">`Add`</mark> 웹훅 상세 조회 ( /v1/webhook/detail )

#### \[기타]

웹훅에 발송 결과 알림(Result Notification) 콜백 스펙이 추가되었습니다.
{% endupdate %}

{% update date="2026-03-11" %}

## v1.1.0

***

API 가 추가/제거 되었습니다.

#### \[변경사항]

**메시지**

* <mark style="color:$primary;">`Add`</mark> 알림톡 발송 ( /v1/message/send/alimtalk  )
* <mark style="color:$primary;">`Add`</mark> 이메일 발송 ( /v1/message/send/email )
* <mark style="color:$primary;">`Add`</mark> 메시지 상태 조회 ( /v1/message/status )
* <mark style="color:$primary;">`Add`</mark> 메시지 목록 조회 ( /v1/message/list )
* <mark style="color:$primary;">`Add`</mark> 메시지 예약 취소 ( /v1/message/cancel )
* <mark style="color:$danger;">`Deprecated`</mark> ~~메시지 발송( /v1/message/send )~~

**채널**

* <mark style="color:$primary;">`Add`</mark> 발송 채널 목록 조회 ( /v1/channel/list )

**템플릿**

* <mark style="color:$primary;">`Add`</mark> 템플릿 목록 조회 ( /v1/template/list )
* <mark style="color:$primary;">`Add`</mark> 템플릿 상세 조회 ( /v1/template/detail )

**포인트**

* <mark style="color:$primary;">`Add`</mark> 포인트 잔액 조회 ( /v1/point/balance )

#### \[기타]

* 목록에 cursor 기반 pagination 적용되었습니다.
  {% endupdate %}

{% update date="2026-02-13" %}

## v1.0.0

***

에이샌드 API가 게시되었습니다.

#### API 문서 게시

* API 문서가 최초 게시되었습니다.
* 메시지 발송(/v1/message/send)이 추가되었습니다.
  {% endupdate %}
  {% endupdates %}