설정 변경
자동충전 요청 한도와 만료 시간 등의 설정을 변경합니다.
PATCH
https://bank.dmolto.com/settings전달한 필드만 부분적으로 업데이트하고, 변경 후 현재 설정 전체를 반환합니다.
Keep-login 설정 주의
keep_login_config는 응답에 다시 표시되지 않습니다. 설정 여부만 keep_login_configured로 확인할 수 있습니다.요청 본문
| 필드 | 타입 | 필수 | 제한 | 예시 |
|---|---|---|---|---|
bank_name입금 안내에 표시할 은행명입니다. | string | 선택 | 32자 이하 | "국민은행" |
bank_account입금 안내에 표시할 계좌번호입니다. | string | 선택 | 64자 이하 | "123-456-789012" |
account_holder입금 안내에 표시할 예금주입니다. | string | 선택 | 64자 이하 | "dmolto" |
minimum_charge_krw허용되는 최소 충전 금액입니다. | integer | 선택 | 1,000 이상 | 1000 |
charge_expire_minutes충전 요청이 pending 상태로 유지되는 시간입니다. | integer | 선택 | 1~60 | 3 |
prior_deposit_match_minutes입금 알림이 요청보다 먼저 도착했을 때 선입금을 보관할 시간입니다. 0이면 비활성화됩니다. | integer | 선택 | 0~60 | 1 |
recharge_cooldown_seconds새 충전 요청 사이의 최소 대기 시간입니다. | integer | 선택 | 0~3600 | 60 |
cultureland_idPIN 충전에 사용할 Cultureland 계정 ID입니다. | string | 선택 | — | "cl_service_id" |
keep_login_configCultureland keep-login 설정입니다. 응답에는 원문이 다시 포함되지 않습니다. | string | 선택 | 16KB 이하 | "key=value;..." |
fee_percentPIN 충전 금액에서 차감할 수수료율입니다. | integer | 선택 | 0~100 | 10 |
curl -X PATCH "https://bank.dmolto.com/settings" \
-H "Authorization: $BANK_API_KEY" \
-H "Content-Type: application/json" \
--max-time 10 \
-d '{
"minimum_charge_krw": 1000,
"charge_expire_minutes": 3,
"recharge_cooldown_seconds": 60
}'응답
200변경된 설정
{
"bank": {
"bank_name": "국민은행",
"bank_account": "123-456-789012",
"account_holder": "dmolto",
"minimum_charge_krw": 1000,
"charge_expire_minutes": 3,
"prior_deposit_match_minutes": 1,
"recharge_cooldown_seconds": 60
},
"pin": {
"cultureland_id": "cl_service_id",
"keep_login_configured": true,
"fee_percent": 10
},
"webhooks": []
}주요 오류
| 상태 | error |
|---|---|
| 400 | invalid_bank_name |
| 400 | invalid_bank_account |
| 400 | invalid_account_holder |
| 400 | invalid_minimum_charge_krw |
| 400 | invalid_charge_expire_minutes |
| 400 | invalid_prior_deposit_match_minutes |
| 400 | invalid_recharge_cooldown_seconds |
| 400 | invalid_cultureland_id |
| 400 | invalid_fee_percent |
| 429 | rate_limit_exceeded |