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

카카오모먼트

결제 관리

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

무통장입금 가상계좌 생성

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

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

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

Request
URL
POST /openapi/v4/billing/virtualAccount HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String 액세스 토큰
Bearer ${ACCESS_TOKEN} 형식으로 전달
O
adAccountId Long 광고계정 ID O
Parameter
Name Type Description Required
amount Integer 입금금액 O
bankCode String 은행코드
03 : 기업은행
04 : 국민은행
11 : 농협은행
81 : 하나은행
20 : 우리은행
88 : 신한은행
39 : 경남은행
71 : 우체국
32 : 부산은행
31 : 대구은행
O
Response
Name Type Description
accountNumber String 가상계좌 번호
accountOwnerName String 가상계좌 소유주 이름
amount Integer 입금금액
bankCode String 은행코드
bankName String 은행이름
expireDttm String 가상계좌 만료 일시
Sample
Request
curl -X GET "https://apis.moment.kakao.com/openapi/v4/billing/virtualAccount" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: ${adAccountId}" \
    -d '{
            "amount" : 1000000,
            "bankCode" : "88"
        }'
Response
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"
}

더보기