아이템 타이머

타이머는 다음을 관리하는 추가 방법입니다. 지급 수명 주기를 참조하십시오. 구독 또는 프리미엄 앱 기능과 같은 제품 및 서비스에 대한 임시 액세스를 제공할 때 유용할 수 있습니다. 타이머에는 다음이 필요합니다. customerId 요청과 함께 전달될 속성입니다. customerId 가치는 당신 쪽에서 생성됩니다.

OmniCart는 두 사이의 관계를 기억합니다. customerId value 및 항목 식별자를 사용하여 지정된 고객에 대한 활성 타이머가 있는 항목을 구매하지 못하도록 합니다. 타이머는 에서 활성화된 것으로 간주됩니다. pending, started그리고 paused 상태( 타이머 수명 주기 아래 섹션).

타이머 수명 주기

타이머 상태는 다음을 사용하여 검색할 수 있습니다. 상태 요청을 사용합니다. 이러한 상태는 항목별로 반환됩니다.

타이머 상태(클릭 가능)

pending

이 pending 상태는 현재 항목이 설정된 타이머 트리거 이벤트에 들어가지 않았음을 의미합니다. 활성 상태이며, 이는 동일한 상태로 이 항목을 포함하는 다른 카트를 시작할 수 없음을 의미합니다. customerId 값.

에서 pending state 타이머는 트리거 이벤트에 의해 또는 수동으로 시작될 수 있습니다(위의 타이머 시작 섹션 참조).

started

이 started 카운트다운이 켜져 있는 상태입니다. 남은 시간(초)은 의 값입니다. remainingSecs 의 속성 timerSnapshot 개체를 status 응답에 추가합니다.

paused

이 paused status는 타이머가 수동으로 중지되었음을 의미합니다. modify 요청. 활성 상태이며, 이는 동일한 상태로 이 항목을 포함하는 다른 카트를 시작할 수 없음을 의미합니다. customerId 값. 이 상태에서 타이머는 수동으로 일시 중지를 해제하거나 중지할 수 있습니다.

stopped

타이머가 들어갑니다. stopped 상태를 사용하여 수동으로 중지한 후 modify 요청. 이것으로 타이머 수명 주기가 끝납니다. 이 상태에서 현재 항목에 대한 타이머 및 customerId 다시 시작할 수 없습니다. 새 타이머를 시작하려면 다음을 사용하여 새 장바구니를 시작하십시오. init 를 사용하여 기존 카트 항목에 대한 타이머를 요청하거나 활성화합니다. modify 요청.

elapsed

타이머가 들어갑니다. stopped 타이머 설정에 지정된 시간(초)이 경과할 때의 상태입니다. 이것으로 타이머 수명 주기가 끝납니다. 이 상태에서 현재 항목에 대한 타이머 및 customerId 다시 시작할 수 없습니다. 새 타이머를 시작하려면 다음을 사용하여 새 장바구니를 시작하십시오. init 를 사용하여 기존 카트 항목에 대한 타이머를 요청하거나 활성화합니다. modify 요청.

타이머 사용

기본적으로 타이머는 사용하지 않도록 설정되어 있습니다(설정되지 않음). 다음을 사용하여 지불 수명 주기가 시작될 때 타이머를 활성화할 수 있습니다. init 요청 또는 결제 프로세스의 다른 단계에서 modify 요청. 타이머를 활성화하면 시작 조건 및 카운트다운 값과 같은 설정을 정의할 수 있습니다.

팁

와 함께 modify 요청, 현재 상태에 관계없이 언제든지 타이머를 비활성화할 수 있습니다.

타이머 시작

타이머는 트리거 이벤트에 의해 또는 수동으로 시작할 수 있습니다. 시작될 때까지 활성화된 타이머는 pending 상태.

트리거 이벤트

트리거 이벤트는 항목입니다. 결제 상태를 사용합니다. 예를 들어 authorized 트리거 이벤트로 타이머는 항목이 들어가자마자 카운트다운을 시작합니다. authorized 상태. 미래, 현재 또는 과거의 트리거 이벤트를 선택할 수 있습니다. 다음 예를 고려해 보십시오.

• 를 사용하여 타이머를 설정합니다. init 를 사용하여 요청하십시오. started status를 트리거 이벤트로 사용합니다. 항목 타이머 카운트다운은 요청이 오류 없이 처리된 직후에 시작됩니다.
• 현재 항목 상태는 다음과 같습니다. captured 그리고 다음을 사용하여 타이머를 설정합니다. modify 를 사용하여 요청하십시오. authorized status를 트리거 이벤트로 사용합니다. authorized 상태가 captured 상태보다 앞서므로, 요청이 오류 없이 처리된 직후에 항목 타이머 카운트다운이 시작됩니다.
• 환불되기 전에 아이템이 시작되지 않았거나 어떤 상태에도 없습니다. 환불 상태를 트리거 이벤트로 하여 init 또는 modify 요청을 사용하여 타이머를 설정합니다. 아이템이 refunded 상태로 전환되면 아이템 타이머 카운트다운이 시작됩니다.

팁

타이머를 사용할지 여부와 활용 방법은 귀하에게 달려 있습니다. 마지막 예를 언급하는 경우 어떤 이유로 고객이 환불을 요청한 품목을 특정 기간(또는 카운트다운 값이 설정된 경우 영원히) 구매하지 못하도록 할 수 있습니다. 0).

수동 시작

활성화된 타이머는 에서 수동으로 시작할 수 있습니다. pending 또는 paused 상태를 modify 요청. 이전에 설정된 트리거 이벤트 전에 타이머를 수동으로 시작할 수 있습니다. 이 경우 타이머가 카운트다운을 계속합니다. 타이머가 수동으로 시작되고 이전에 설정된 트리거 이벤트보다 먼저 경과하면 다음과 같이 다시 시작되지 않습니다. elapsed 상태는 타이머 수명 주기에서 최종입니다.

카운트다운

타이머는 카운트다운으로 작동하며 값은 초 단위로 지정됩니다. 예를 들어 타이머를 2시간으로 설정하려면 7200 의 타이머 값으로 init 또는 modify 요청. 3일 동안 타이머를 설정해야 하는 경우 259200 등등.

팁

값 0을 전달하면 타이머는 무한합니다. 예를 들어, 비디오 게임의 독특한 유물이나 일회성 PRO 업그레이드와 같이 한 번 이상 구매할 수 없는 아이템에 이를 활용할 수 있습니다. 나중에 언제든지 modify로 타이머 설정을 변경할 수 있습니다.

타이머 수명 주기의 끝

타이머가 경과하거나 수동으로 중지되면 수명 주기가 끝나고 다시 시작할 수 없습니다. 항목에 대한 새 타이머를 설정하려면 다음을 사용하여 새 카트를 시작(또는 기존 카트 수정)해야 합니다. customerId 값 및 타이머 설정.

카운트다운 종료

타이머의 카운트다운은 타이머 설정에 지정된 시간(초)이 종료될 때 종료됩니다. init 또는 modify 요청이 경과합니다. 타이머가 시작된 후 수동으로 일시 중지하면 수동으로 일시 중지가 해제될 때까지 카운트다운이 멈춥니다. 타이머의 일시정지를 해제하려면 시작하다 의 값 manualAction 속성을 modify 요청.

노트

일시 중지된 타이머는 여전히 활성 상태입니다. 즉, 동일한 항목으로 현재 항목을 시작할 수 없습니다. customerId 타이머가 경과하거나 수동으로 중지될 때까지의 값입니다.

수동 정지

타이머는 수동으로 중지할 수 있습니다. paused 또는 started 상태. 타이머를 중지하려면 stop 의 값 manualAction 속성을 modify 요청.

참고해주세요

현재 항목에 대해 중지된 타이머를 다시 시작할 수 없습니다. 새 타이머를 시작하려면 다음을 사용하여 새 카트를 시작(또는 기존 카트 수정)하십시오. customerId 값 및 타이머 설정.