Point Issuance Request

포인트 충전 요청

포인트 충전 요청 시 가상계좌가 채번되며, 충전 요청은 최초 READY 상태로 생성됩니다.

충전 요청의 상태는 아래와 같이 변경됩니다.

READY
가상계좌가 채번된 상태로, 입금 대기 중인 충전 요청입니다.

DONE
입금이 정상적으로 완료되어 충전이 성공적으로 처리된 상태입니다.

FAIL
충전 처리 과정에서 오류가 발생하여 충전이 실패한 상태입니다.
(FAIL 상태의 요청은 재사용할 수 없습니다.)

CANCELLED
입금 진행 이전에 충전 요청이 취소된 상태입니다.

READY 상태의 충전 요청이 존재하는 동안에는 새로운 충전 요청을 생성할 수 없습니다.
새로운 충전 요청은 기존 요청이 DONE 또는 CANCELLED 상태로 변경된 이후에만 가능합니다.

이미 READY 상태인 충전 요청이 존재함에도 추가로 충전 요청을 생성할 경우,
해당 요청은 실패 처리됩니다.

고정식 무제한 가상계좌 사용 시

요청 시 전달한 amount 값과 관계없이 실제 입금된 금액 기준으로 충전이 진행됩니다.

충전이 완료되어 요청 상태가 DONE으로 변경되면,
가상계좌 만료 시점까지 추가 입금 및 재충전은 불가합니다.

When a point Issuance request is created, a virtual account is issued and the request is initially set to the READY state.

The Issuance request status transitions as follows:

READY
A virtual account has been issued and the system is waiting for a deposit.

DONE
The deposit has been successfully completed and the Issuance is processed.

FAIL
The Issuance failed due to an error during processing.
Requests in the FAIL state cannot be reused.

CANCELLED
The Issuance request was cancelled before any deposit was made.

While a Issuance request is in the READY state, no additional Issuance requests can be created.
A new Issuance request can only be made after the existing request transitions to
DONE or CANCELLED.

If a Issuance request is created while another READY request already exists,
the request will fail.

Fixed Unlimited Virtual Account

Issuance is processed based on the actual deposited amount, regardless of the requested amount.

Once the Issuance is completed and the request transitions to DONE,
additional deposits or Issuance are not allowed until the virtual account expires.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

application/json

Body

Example

{
    "data": {
        "id": "123",
        "amount": 0,
        "status": "WAITED",
        "createdAt": "2023-10-27T10:00:00",
        "modifiedAt": "2023-10-27T10:00:05",
        "preparedVbankInfo": {
            "vbankDueDate": "2023-10-28T23:59:59",
            "vbankAccountNumber": "451235741265",
            "bankName": "국민은행",
            "vbankHolderName": "번개장터"
        }
    }
}

Point Issuance Request

포인트 충전 요청

고정식 무제한 가상계좌 사용 시