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

카카오모먼트

결제 관리

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

무통장입금 가상계좌 생성

기본 정보

POST /openapi/v4/billing/virtualAccount HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}

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

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

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

Request

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"
}

더보기

카카오모먼트> 결제 관리