결제 관리

이 문서는 결제 관리 API 사용 방법을 안내합니다.

무통장입금 가상계좌 생성

기본 정보

메서드	URL	인증 방식
POST	https://apis.moment.kakao.com/openapi/v4/billing/virtualAccount	액세스 토큰

권한	사전 설정	카카오 로그인	사용자 동의
필요	플랫폼 등록 카카오 로그인 활성화 비즈 앱	필요	-

무통장 입금을 위한 가상계좌를 생성합니다.

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 POST로 요청합니다. 가상계좌를 생성할 은행 코드와 입금할 금액, 대상 광고계정의 번호를 필수 파라미터로 전달해야 합니다. 실패 시 에러 코드 및 상세 에러 코드로 사유를 확인합니다.

이 API는 사용자 계정마다 1초에 한 번씩 요청이 가능하도록 제한되어 있습니다.

요청

헤더

이름	설명	필수
Authorization	Authorization: Bearer ${ACCESS_TOKEN} 인증 방식, 액세스 토큰으로 인증 요청	O
adAccountId	adAccountId: ${AD_ACCOUNT_ID} 광고계정 ID	O

본문

이름	타입	설명	필수
adAccountId	Integer	광고계정 ID	O
amount	Integer	입금금액	O
bankCode	String	은행코드 03 : 기업은행 04 : 국민은행 11 : 농협은행 81 : 하나은행 20 : 우리은행 88 : 신한은행 39 : 경남은행 71 : 우체국 32 : 부산은행 31 : 대구은행	O

응답

본문

이름	타입	설명
accountNumber	String	가상계좌 번호
accountOwnerName	String	가상계좌 소유주 이름
amount	Integer	입금금액
bankCode	String	은행코드
bankName	String	은행이름
expireDttm	String	가상계좌 만료 일시

예제

요청

curl -X GET "https://apis.moment.kakao.com/openapi/v4/billing/virtualAccount" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}" \
    -d '{ 
            "adAccountId" : 12345,
            "amount" : 1000000, 
            "bankCode" : "88" 
        }'

응답

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "accountNumber": "X123456789012",
    "accountOwnerName": "(주)카카오",
    "amount": 1000000,
    "bankCode": "88",
    "bankName": "신한",
    "expireDttm": "2020-08-17T17:28:12.683"
}

더 보기

카카오모먼트 API 레퍼런스