분할 결제 POC: 개념 증명 후 다음 단계

이 자습서에서 빌드한 데모 대시보드 및 시뮬레이션 스크립트는 의도적으로 거칠게 되었습니다. 그들은 패턴을 증명하기 위해 존재한다. 이 페이지에서는 개념 증명에서 프로덕션 스타일 App Builder 개발까지의 실제 경로에 대해 설명합니다.

1단계 — 데모 대시보드를 Experience Cloud UI 확장으로 바꾸기

demo-dashboard 웹 작업은 Node.js 함수 내의 문자열에서 HTML을 제공합니다. 작동은 하지만 생산 패턴은 아닙니다.

적절한 대체 요소는 commerce-checkout-starter-kit의 commerce-backend-ui-1 확장(Adobe Admin UI SDK을 통해 Commerce Admin Shell에 포함된 React 애플리케이션)입니다. 생성 프롬프트는 분할 결제 POC: Experience Cloud UI 확장 AI 프롬프트를 참조하십시오.

변경 내용:

동일하게 유지되는 항목:

2단계 — 실제 ERP 연결

이 PoC의 수락/거절 흐름은 사용자가 버튼을 클릭하여 구동됩니다. 프로덕션 환경에서 ERP, CRM 또는 결제 프로세서에 의해 구동됩니다.

통합 패턴:

PHP 변경이 필요하지 않습니다. REST면이 이미 있습니다 App Builder 작업에는 대시보드 단추 대신 보안 호출자가 필요합니다.

ERP 호출자에 대한 인증 옵션:

3단계 — API 메쉬를 브로커 계층으로 추가

현재 App Builder은 OAuth 1.0a 자격 증명으로 Commerce REST를 직접 호출합니다. 대규모 배포의 경우 Adobe API Mesh는 App Builder과 Commerce 간에 관리되는 게이트웨이 계층을 제공합니다.

이점:

패턴:

4단계 — PHP Footprint 감소

현재 PHP 모듈은 진행 중이어야 하는 5가지 사항을 처리합니다(분할 결제 POC: 아키텍처 및 디자인 결정 참조). Adobe Commerce의 API 표면이 발달함에 따라 이러한 API 중 일부는 이동할 수 있게 될 수 있습니다.

향후 이동 가능:

이동할 수 없음(아키텍처 제한):

5단계 — App Builder에 워크플로우 추가

현재 PoC는 주문 배치를 수신한 다음 수락/거부를 활성화하는 한 가지 작업을 수행합니다. 자연어 확장:

수락하기 전 부정 채점:
payment-orchestrator에서 보류 중인 현금을 기록한 후 오케스트레이션 결과가 최종으로 간주되기 전에 부정 채점 API를 호출합니다. 점수가 임계값을 초과하는 경우 연산자 작업을 기다리지 않고 자동 거부를 수행합니다.

알림 전자 메일:
payment-accept이(가) 성공하면 현금 결제가 확인되었음을 고객에게 알리는 이메일(Adobe Campaign, SendGrid 또는 HTTPS API를 통해)을 트리거합니다.

충성도 포인트 상:
현금이 확인되면 충성도 API를 호출하여 포인트를 부여합니다. 이것은 순수 App Builder — PHP가 필요하지 않습니다.

시간 제한 처리:
split_cash_status = 'pending'이(가) X일보다 오래된 주문을 검색하고 자동으로 거부하는 예약된 App Builder 작업(app.config.yaml에서 cron 사용)을 추가합니다.

6단계 — 프로덕션에 배포

Stage 작업 영역에 대해 PoC가 구성되었습니다. 프로덕션으로 이동:

# Switch to production workspace
aio app use
# Select Production workspace

# Update .env for production
# (same credentials, but production Commerce base URL)

# Deploy
aio app deploy

프로덕션 준비 확인 목록:

아키텍처 진화 다이어그램

PoC (this tutorial)
┌─────────────────────────────────────────────────┐
│  Commerce                 App Builder            │
│  ┌─────────────┐         ┌──────────────────┐   │
│  │  PHP Module │◄────────│ payment-orchestr │   │
│  │  REST API   │────────►│ payment-accept   │   │
│  │  Checkout UI│         │ payment-decline  │   │
│  └─────────────┘         │ demo-dashboard   │   │
└─────────────────────────────────────────────────┘

Phase 2: Experience Cloud UI
┌─────────────────────────────────────────────────┐
│  Commerce                 App Builder            │
│  ┌─────────────┐         ┌──────────────────┐   │
│  │  PHP Module │◄────────│ payment-orchestr │   │
│  │  REST API   │────────►│ payment-accept   │   │
│  │  Checkout UI│         │ payment-decline  │   │
│  │             │         │ Admin UI ext.    │   │
│  └─────────────┘         └──────────────────┘   │
└─────────────────────────────────────────────────┘

Phase 3: Real ERP + API Mesh
┌──────────────────────────────────────────────────────────┐
│  ERP  ──►  App Builder  ──►  API Mesh  ──►  Commerce     │
│            (orchestrator)   (gateway)    (PHP module      │
│            (accept)                      REST surface)    │
└──────────────────────────────────────────────────────────┘

주요 참조

이 시리즈의 모든 리소스

참조 리소스