Shop Cash를 위한 시스템 준비

타사 시스템에서 Shop Cash 워크플로를 출시하기 전에 다음 요구 사항을 확인하십시오.

• ERP, OMS, 주문 처리, 회계 및 반품 시스템에서 하나의 주문에 두 개 이상의 결제 방법을 수락할 수 있습니다.
• 게이트웨이 값을 사용할 수 있는 경우 shop_cash가 결제 방법으로 매핑됩니다.
• Shop Cash는 할인, 기프트 카드 또는 스토어 크레딧으로 처리되지 않습니다.
• 승인 값은 1024자 이상의 불투명한 가변 길이 문자열로 저장됩니다. 가능한 경우 제한이 없는 텍스트 필드를 사용하십시오.
• 캡처, 무효 처리 및 환불은 승인 값이 아닌 거래 ID로 식별됩니다. Admin API 캡처 및 무효 처리 작업에서는 parentTransactionId를 사용하고 환불 작업에서는 parentId를 사용합니다.
• 시스템에서 Shop Cash 승인 값을 구문 분석, 디코딩, 정규화, 해시 또는 자르지 않습니다.
• 시스템에서 하나의 shop_cash_credit 행이 여러 주문을 나타낼 수 있는 그룹화된 지급액을 처리할 수 있습니다.
• 조정 워크플로에서 단일 주문이 하나의 지급액 행과 같다고 가정하지 않습니다.
• 조정 워크플로에서 각기 다른 지급액으로 정산되는 Shop Cash 부분과 카드 또는 Shop Pay 할부 부분을 처리할 수 있습니다.
• 환불 워크플로에서 카드 또는 Shop Pay 할부와 Shop Cash 전반에 걸친 부분 환불을 처리할 수 있습니다.
• 환불 앱은 승인 거래가 아닌 Shop Cash 캡처 거래를 환불할 수 있습니다.
• 2026년 1월 이전에 Shop Campaigns를 실행한 경우 재무 워크플로에서 과거 shop_cash_campaign_billing_debit 및 관련 캠페인 청구 행을 주문 매출과 별도로 처리합니다. 2026년 1월 이후의 캠페인 비용은 대신 Shopify 청구서에 청구됩니다.

Shop Cash는 Shop 구매자 계정, Shop Cash 잔액, Shopify Payments 및 Shop Cash 정산 인프라에 의존하므로 Shop Cash 테스트에는 제한이 있습니다.

엔터프라이즈급 연동을 엔드투엔드로 검증하는 가장 신뢰할 수 있는 방법은 Shop을 통해 소액의 프로덕션 주문을 생성한 다음 환불하는 것입니다. 이를 통해 Shopify 관리자, Admin API 데이터, 지급액 내보내기 및 지급액 API 데이터를 통해 처리되는 실제와 유사한 주문 거래, 캡처 데이터, 지급액 활동, 환불 거래 및 환불 차감 활동이 생성됩니다.

개발 스토어는 일부 API 필드 형태 및 매핑 로직을 검증하는 데 도움이 될 수 있지만, Shop에서 시작된 전체 체크아웃, 구매자 잔액 및 정산 흐름을 안정적으로 실행하지는 않습니다. 테스트 모드와 Bogus 게이트웨이는 라이브 Shopify Payments 정산 흐름을 사용하지 않으므로 실제와 유사한 Shop Cash 지급액 행을 생성하지 않습니다.

일반적으로 Shop에서 시작된 소액 프로덕션 주문을 사용하여 다음 워크플로를 테스트할 수 있습니다.

• Shop Cash 및 Shop Pay 또는 Shop Pay 할부가 포함된 다중 결제 방법 주문의 주문 수집.
• shop_cash의 ERP 또는 OMS 매핑.
• 전체 Shop Cash 승인 값의 저장.
• 주문에 대한 전체 및 부분 환불.
• shop_cash_refund_debit 지급액 활동의 수집.
• Shop Cash 크레딧에 대한 지급액 조정.
• 스토어에서 지연 캡처를 사용하는 경우 선주문 또는 주문 처리 시 캡처 동작.
• 결제 방법이 두 개 이상인 주문에 대한 반품 앱 처리.

프로덕션 환경에서 테스트할 때는 소액 주문을 사용하고 스토어의 내부 주문 테스트 및 환불 절차를 따르십시오.

다음 시나리오와 관련하여 도움이 필요한 경우 Shopify 지원팀에 문의하십시오.

• 롤아웃 중인 시장의 Shop Cash 사용 가능성 검토.
• 실패한 Shop Cash 캡처 또는 환불 조사.
• 일반적인 지급액 주기와 추가 1회의 지급액 주기가 지난 후 누락된 Shop Cash 지급액 거래 조사.
• 무효 처리되거나 만료된 Shop Cash 승인을 재승인할 수 있는지 여부 검토.
• 복잡한 ERP, OMS, 선주문 또는 주문 처리 워크플로의 출시 계획.

Shop Cash 주문량을 확장하기 전에 다음 확인 사항을 완료하십시오.

• shop_cash에 대한 ERP 및 OMS 결제 방법 매핑이 배포되고 확인되었습니다.
• 승인 및 캡처 거래를 포함한 샘플 Shop Cash 주문이 엔드투엔드로 수집되었습니다.
• 샘플 Shop Cash 지급액 크레딧이 원본 주문과 조정되었습니다.
• 샘플 Shop Cash 환불이 처리되고 환불 차감액과 조정되었습니다.
• 그룹화된 Shop Cash 지급액 행이 지원되거나 수동 조정 프로세스가 있습니다.
• 지원 및 재무 팀에서 부분 환불 할당을 이해하고 있습니다.
• 해당되는 경우 선주문, 수동 캡처 및 주문 처리 시 캡처 동작이 검증되었습니다.
• 반품 앱에서 올바른 Shop Cash 캡처 거래를 식별하고 환불할 수 있습니다.
• 지원 및 재무 팀에서 고객 Shop Cash 잔액, Shop 혜택 및 Shop Campaign 청구 활동의 차이점을 알고 있습니다.

API 및 주문 데이터 요구 사항은 Shop Cash 주문 데이터 및 타사 연동을 참조하십시오. 지급액 요구 사항은 Shop Cash 지급액 조정을 참조하십시오.