페이지 이동경로
  • 문서>
  • 카카오모먼트>
  • 결제 관리

카카오모먼트

결제 관리

이 문서는 결제 관리 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"
}

더 보기

카카오모먼트> 결제 관리