자동 충전

자동 잔액 충전: 잔액이 설정된 기준치 이하로 떨어지면, 저장된 결제 수단을 통해 설정된 금액이 청구됩니다. 이용 가능 지역: API v2 전용 — v1 버전에 해당하는 항목은 없습니다.

서버에서 해당 기능이 활성화되어 있어야 합니다. 기능이 비활성화된 경우, 양쪽 엔드포인트 모두 Auto top-up is not available.

종점:

이 요청은 현재 자동 충전 설정과 마지막 트리거 결과를 반환합니다.

GEThttps://proxy-seller.com/personal/api/v2/{YourApiKey}/balance/autotopup/get

경로 매개변수

이름	값	설명
승인	`<Your_API_Key>`	귀하의 개인 API 키 (받는 방법)

예시

https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/balance/autotopup/get

답변

{
    "status": "success",
    "data": {
        "configured": true,
        "enabled": true,
        "state": "ACTIVE",
        "threshold": 10,
        "amount": 25,
        "subscriptionId": "sub_01hx9k2m4p",
        "paymentMethod": {
            "id": "sub_01hx9k2m4p",
            "status": "active",
            "paymentMethod": "card",
            "brand": "visa",
            "last4": "1234",
            "exp": "05/2027"
        },
        "dailyCountCap": 5,
        "monthlyAmountCap": 500,
        "failCount": 0,
        "lastAttemptAt": "2026-08-14T09:12:44.000+00:00",
        "lastEvent": {
            "status": "SUCCEEDED",
            "amount": 25,
            "at": "2026-08-14T09:12:46.000+00:00",
            "reason": null
        }
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Auto top-up is not available",
            "code": 49,
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Error api key",
            "code": 503,
            "customData": null
        },
        {
            "message": "IP not allowed",
            "code": 503,
            "customData": null
        },
        {
            "message": "Request limit reached",
            "code": 503,
            "customData": null
        }
    ]
}

설정 변경

종점:

이 요청은 자동 충전 설정을 업데이트합니다. 부분 업데이트: 생략한 필드는 저장된 값을 그대로 유지하므로, 임계값만 변경하려면 다음을 전송하면 됩니다. threshold.

POSThttps://proxy-seller.com/personal/api/v2/{YourApiKey}/balance/autotopup/set

경로 매개변수

이름	값	설명
승인	`<Your_API_Key>`	귀하의 개인 API 키 (받는 방법)

요청 본문

이름	유형	설명
활성화됨	부울	자동 충전 기능 켜기 또는 끄기
임계값	번호	잔액이 이 값보다 낮아지면 충전하십시오. 최소 `1`
금액	번호	1회 충전 금액. 최소 `5`, 그리고 다음보다 크거나 같아야 한다. `threshold`
구독 ID	문자열	결제 수단 정보 출처: `paymentMethod.id`. 카드가 하나뿐인 경우에만 선택 사항입니다.
dailyCountCap	번호	24시간당 충전 횟수에 대한 사용자 지정 상한선. 최소 `1`
월별 한도액	번호	30일당 총 한도액. 다음 값 이상이어야 합니다. `amount`

예시

https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/balance/autotopup/set

답변

{
    "status": "success",
    "data": {
        "configured": true,
        "enabled": true,
        "state": "ACTIVE",
        "threshold": 10,
        "amount": 25,
        "subscriptionId": "sub_01hx9k2m4p",
        "paymentMethod": {
            "id": "sub_01hx9k2m4p",
            "status": "active",
            "paymentMethod": "card",
            "brand": "visa",
            "last4": "4242",
            "exp": "05/2027"
        },
        "dailyCountCap": 5,
        "monthlyAmountCap": 500,
        "failCount": 0,
        "lastAttemptAt": null,
        "lastEvent": {
            "status": "SETTINGS_SAVED",
            "amount": null,
            "at": "2026-08-14T10:03:11.000+00:00",
            "reason": "enabled: false -> true"
        }
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Top-up amount must be #min_amount# or more",
            "code": 51,
            "customData": {
                "minAmount": 5
            }
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Top-up amount must cover the threshold, otherwise it will trigger again",
            "code": 52,
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Auto top-up requires a saved payment method",
            "code": 53,
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Your saved card has expired — update it to enable auto top-up",
            "code": 56,
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Threshold must be #min_threshold# or more",
            "code": 50,
            "customData": {
                "minThreshold": 1
            }
        }
    ]
}

다음에 대한 유효성 검사 실행 병합됨 결과, 요청 자체만을 기준으로 하는 것이 아닙니다. 전송 threshold 저장된 내용이 amount 결국 새로운 기준치보다 낮아지게 된다.
일련의 돌격 시도가 실패한 후의 일시 정지 상태는 다음의 경우에만 해제됩니다. enabled: true 명시적으로 전송됩니다. 일시 중지된 구성에서 다른 필드를 편집하더라도 일시 중지 상태는 유지됩니다.
사용자가 'none'을 설정한 경우에도 유효한 상한값이 적용됩니다: 5 24시간당 충전 횟수 및 500 지난 30일 기준.

종점:

경로 매개변수

예시

답변

설정 변경

종점:

경로 매개변수

요청 본문

예시

답변

On this page