PIN 충전
등록된 Cultureland 계정을 통해 상품권 PIN을 발급합니다.
POST
https://pin.apiacc.com/request지정한 금액과 수량만큼 문화상품권 PIN을 발급하고, 발급된 PIN 번호를 응답으로 반환합니다.
사전 조건
이 API를 호출하기 전에
Cultureland 설정 API로 계정을 먼저 등록해야 합니다.요청 본문
| 필드 | 타입 | 필수 | 제한 | 예시 |
|---|---|---|---|---|
amount발급할 상품권 1매당 금액입니다. | integer | 필수 | 5,000 / 10,000 / 30,000 / 50,000 중 하나 | 5000 |
quantity발급할 상품권 매수입니다. | integer | 필수 | 1~50 | 1 |
ref요청을 식별하는 고유 참조 번호입니다. 중복 발급을 방지하는 데 사용됩니다. | string | 필수 | — | "order_5678" |
curl -X POST "https://pin.apiacc.com/request" \
-H "Authorization: Bearer $PIN_API_KEY" \
-H "Content-Type: application/json" \
--max-time 10 \
-d '{
"amount": 5000,
"quantity": 1,
"ref": "order_5678"
}'응답
201PIN 발급 성공
{
"request": {
"id": "pin_req_abc123",
"amount": 5000,
"quantity": 1,
"ref": "order_5678",
"status": "issued",
"pins": [
{
"pin": "3120-1234-5678-9012",
"expires_at": "2027-08-15"
}
],
"issued_at": "2026-08-15T03:40:00Z"
}
}주요 오류
| 상태 | error |
|---|---|
| 400 | invalid_amount |
| 400 | invalid_quantity |
| 402 | insufficient_balance |
| 409 | duplicate_ref |
| 424 | cultureland_unavailable |
| 429 | rate_limit_exceeded |