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