분할 결제 POC: 테스트 및 확인 가이드

이 안내서에서는 테스트해야 하는 순서대로 모든 구성 요소가 제대로 작동하는지 확인하는 과정을 안내합니다. 맨 아래(Commerce 모듈)에서 시작하여 위로(App Builder) 이동합니다.

1단계 — Commerce 모듈 설치 확인

bin/magento setup:upgrade 및 bin/magento setup:di:compile을(를) 실행한 후:

# Confirm module is enabled
bin/magento module:status Client_SplitPayment

# Confirm db_schema columns were added
bin/magento doctrine:schema:validate
# or check directly:
mysql -u <user> -p <dbname> -e "DESCRIBE sales_order;" | grep split

예상 출력: split_(으)로 시작하는 4개의 열이 sales_order에 표시됩니다.

2단계 — Commerce 관리 구성 확인

Commerce 관리에서:

3단계 — REST 엔드포인트에 액세스할 수 있는지 확인

curl을 사용하여 엔드포인트가 응답하는지 확인합니다(승인되지 않은 요청을 거부하지만 401에서 올바르게 라우팅되는지 확인).

# Should return 401 (not 404) — endpoint exists but requires auth
curl -X POST https://your-store.example.com/rest/V1/split-payment/orders/1/cash-received

# Should return 200 or session-based response — anonymous endpoint
curl -X POST https://your-store.example.com/rest/V1/split-payment/set \
  -H "Content-Type: application/json" \
  -d '{"storeCreditAmount": 0, "cashAmount": 0}'

4단계 — 체크아웃 UI 테스트

테스트 유효성 검사:

5단계 — 임계값 가드 테스트

6단계 — 테스트 분할 지급 주문

주문 배치 후 Commerce 관리에서 다음을 확인하십시오.

App Builder 댓글이 표시되지 않는 경우: aio app logs(으)로 App Builder 작업 로그를 확인하십시오. 이벤트가 실행되지 않거나 작업에 오류가 있을 수 있습니다.

7단계 — 시뮬레이션 스크립트를 통해 승인 테스트

시뮬레이션 스크립트는 전체 연산자 UI 없이 수락/거절 흐름을 테스트할 수 있는 가장 빠른 방법입니다.

cd commerce-checkout-starter-kit
cp commerce-backend-ui-1/.env.simulation.example commerce-backend-ui-1/.env.simulation
# Edit .env.simulation with your credentials

# List recent orders (find your test order entity_id)
node commerce-backend-ui-1/scripts/simulate-split-payment.mjs list

# Show split payment fields for a specific order
node commerce-backend-ui-1/scripts/simulate-split-payment.mjs show 42

# Accept the cash payment
node commerce-backend-ui-1/scripts/simulate-split-payment.mjs accept 42

수락 후 Commerce 관리 순서 보기에서 확인합니다.

8단계 — 시뮬레이션 스크립트를 통한 테스트 감소

다른 테스트 주문(6단계와 동일한 설정)을 수행한 다음,

node commerce-backend-ui-1/scripts/simulate-split-payment.mjs decline <orderId>

거절 후 Commerce 관리자에서 확인합니다.

9단계 — 데모 대시보드 테스트

split-payment-orchestrator을(를) 배포한 후 aio app deploy이(가) 작업 URL을 인쇄합니다.

브라우저에서 demo-dashboard URL을 엽니다.

https://[runtime-host]/api/v1/web/split_payment_orchestrator/demo-dashboard

DEMO_UI_SECRET이(가) 설정된 경우:

https://[runtime-host]/api/v1/web/split_payment_orchestrator/demo-dashboard?secret=<your-secret>

보류 중인 주문:

10단계 — App Builder 작업 로그 테스트

# Follow logs in real-time
aio app logs --tail

# Or view last invocations
aio runtime activation list --limit 10
aio runtime activation logs <activation-id>

payment-orchestrator에 대해 다음을 찾으세요.

[INFO] Split payment orchestration finished { orderId: '42' }

payment-accept 또는 payment-decline의 경우:

[INFO] Cash payment accepted on Commerce via REST { orderId: '42' }

일반적인 문제 및 수정 사항

Commerce OAuth에서 “서명이 잘못되었습니다.”

원인: App Builder 런타임과 Commerce 사이의 클럭 스큐 또는 OAuth 서명 버그입니다.

수정:

분할 결제 필드가 체크아웃에 표시되지 않음

원인: LayoutProcessorPlugin 삽입 경로가 체크아웃 레이아웃과 일치하지 않습니다.

수정:

스토어 크레딧이 적용되지 않음 / 주문 시 “결제를 처리할 수 없음”

원인: 일반적으로 Edge Case 플러그인 중 하나가 제대로 작동하지 않습니다.

확인:

App Builder 작업이 이벤트를 수신하지만 orderId가 누락되었습니다.

원인: io_events.xml 필드 목록에 entity_id이(가) 없거나 이벤트 페이로드 모양이 변경되었습니다.

수정:

주문이 데모 대시보드에 표시되지 않음

원인: Commerce REST orders 검색 조건이 주문을 반환하지 않거나 split_cash_status 필드가 REST 응답에 없습니다.

수정:

확인 검사 목록

이 시리즈의 모든 리소스

참조 리소스