kakao developers

Payment management

This document describes how to use the Payment management APIs.

Create virtual account for direct deposit

This API enables you to create a virtual account for direct deposit.

Send a POST request with the issued access 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.

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	Pass an access token in Bearer ${ACCESS_TOKEN} format.	O
adAccountId	Long	Ad account's ID.	O

Parameter

Name	Type	Description	Required
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

Response

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.

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

See more

• Kakao Moment API Reference