사이드 메뉴
Getting started
Kakao Developers
Login
Communication
Advertisement
- Concepts
- Ad creation: Ad account
- Ad creation: Campaign
- Ad creation: Ad group
- Targeting for ad group
- Custom audience targeting for ad group
- Ad creation: Creative common
- Ad creation: Display creative
- Ad creation: Message creative
- Ad creation: Personalized message creative
- Bizboard landing settings
- Report
- Message management
- Personalized message management
- Message ad management
- Message ad operation
- Ad View management
- Business Form+ management
- Business Form linkage management
- Pixel & SDK linkage management
- Audience management
- Engagement targeting management
- Customer file management
- Friend group management
- Ad account management
- Reference
- Type information
- Error code
Payment management(Deprecated)
This document describes how to use the Payment management APIs.
| Method | URL | Authorization |
|---|---|---|
POST | https://apis.moment.kakao.com/openapi/v4/billing/virtualAccount | Business token |
| Permission | Prerequisite | Business Authentication | Business consent items |
|---|---|---|---|
| Required: Request permission | Switch to a Biz app Set Business redirect URI Business consent items | Required | Required |
Creates a virtual account for direct deposit.
Send a POST request with the issued business token and an ad account ID (adAccountId) in the request header. You must pass the bank code where a virtual account will be created and the deposit amount when you request. If failed, refer to Error code to figure out its failure cause.
This API limits the number of calls you can make to every second per user account.
| Name | Description | Required |
|---|---|---|
| Authorization | Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}Business token as a type of user authentication. | O |
| adAccountId | adAccountId: ${AD_ACCOUNT_ID}Ad account's ID. | O |
| Name | Type | Description | Required |
|---|---|---|---|
| adAccountId | Integer | Ad account's ID. | O |
| amount | Integer | Deposit amount. | O |
| bankCode | String | Bank code. 03: 기업은행 (IBK) 04: 국민은행 (KB Bank) 11: 농협은행 (Nonghyup Bank) 81: 하나은행 (Hana Bank) 20: 우리은행 (Woori Bank) 88: 신한은행 (Shinhan Bank) 39: 경남은행 (Kyongnam Bank) 71: 우체국 (Post Office) 32: 부산은행 (Busan Bank) 31: 대구은행 (Daegu Bank) | O |
| Name | Type | Description |
|---|---|---|
| accountNumber | String | Virtual account's number. |
| accountOwnerName | String | Virtual account's holder name. |
| amount | Integer | Deposit amount. |
| bankCode | String | Bank code. |
| bankName | String | Bank name. |
| expireDttm | String | Virtual account expiration date. |
Request
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"}'
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"}