결제 관리

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

무통장입금 가상계좌 생성

기본 정보

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

권한	사전 설정	비즈니스 인증	비즈니스 동의항목
필요: 사용 권한 신청	비즈 앱 전환 비즈니스 Redirect URI 등록 비즈니스 동의항목	필요	필요

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

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

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

요청

헤더

이름	설명	필수
Authorization	Authorization: Bearer ${BUSINESS_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 ${BUSINESS_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 레퍼런스