POC de pagamento dividido: referência de variáveis de ambiente

As mesmas quatro credenciais do Commerce OAuth são usadas em cada componente. Em Commerce Admin, crie um Integration e reutilize os quatro valores em cada arquivo .env abaixo. (Consulte POC de pagamento dividido: pré-requisitos e configuração de ambiente para as etapas de ativação.)

As quatro credenciais OAuth (usadas em todos os lugares)

Variável
Onde obter
COMMERCE_CONSUMER_KEY
Commerce Admin > System > Integrations > [sua integração]
COMMERCE_CONSUMER_SECRET
O mesmo que acima — os valores são mostrados somente na ativação
COMMERCE_ACCESS_TOKEN
Igual ao anterior
COMMERCE_ACCESS_TOKEN_SECRET
Igual ao anterior

App Builder orchestrator

split-payment-orchestrator/.env

Copie de .env.example no diretório do orquestrador. Não confirme este arquivo.

# Commerce REST base URL — no trailing slash
COMMERCE_BASE_URL=https://your-store.example.com

# OAuth 1.0a integration credentials
COMMERCE_CONSUMER_KEY=
COMMERCE_CONSUMER_SECRET=
COMMERCE_ACCESS_TOKEN=
COMMERCE_ACCESS_TOKEN_SECRET=

# Must match split_payment/general/threshold in Commerce config (default: 100)
# Both Commerce and App Builder fall back to 100 if this is missing, non-numeric, or ≤ 0
PAYMENT_THRESHOLD=100

LOG_LEVEL=info

# Demo dashboard: if set, requires ?secret=<value> in URL or x-demo-secret header
# Leave empty for private staging only (anyone with the URL can list/accept orders)
DEMO_UI_SECRET=

# Optional: override the base URL used in dashboard action links (useful behind proxies)
DEMO_UI_BASE_URL=

Extensão da interface do usuário do Experience Cloud (commerce-checkout-starter-kit)

commerce-checkout-starter-kit/.env

Este componente usa dois conjuntos de credenciais: IMS para listagem de pedidos com a interface do usuário SDK Admin e OAuth 1.0a para ações de aceitação e recusa.

# IMS — used by CustomMenu/commerce-rest-api to list orders
# The Admin UI SDK provides the IMS token context; these set the Commerce base URL
COMMERCE_BASE_URL=https://your-store.example.com
OAUTH_CLIENT_ID=
OAUTH_CLIENT_SECRETS=
OAUTH_TECHNICAL_ACCOUNT_ID=
OAUTH_TECHNICAL_ACCOUNT_EMAIL=
OAUTH_SCOPES=
OAUTH_IMS_ORG_ID=
AIO_CLI_ENV=stage

# OAuth 1.0a — same four credentials, COMMERCE_INTEGRATION_ prefix
COMMERCE_INTEGRATION_BASE_URL=https://your-store.example.com
COMMERCE_INTEGRATION_CONSUMER_KEY=
COMMERCE_INTEGRATION_CONSUMER_SECRET=
COMMERCE_INTEGRATION_ACCESS_TOKEN=
COMMERCE_INTEGRATION_ACCESS_TOKEN_SECRET=

Script de simulação

commerce-backend-ui-1/.env.simulation

Copiar de .env.simulation.example no mesmo diretório.

COMMERCE_BASE_URL=https://your-store.example.com
COMMERCE_CONSUMER_KEY=
COMMERCE_CONSUMER_SECRET=
COMMERCE_ACCESS_TOKEN=
COMMERCE_ACCESS_TOKEN_SECRET=

Notas

PAYMENT_THRESHOLD — Deve corresponder a split_payment/general/threshold na configuração do sistema Commerce. Ambos os lados assumem o padrão 100 se o valor estiver ausente, não for numérico ou for menor ou igual a 0. Se você alterar o limite em Commerce, atualize o App Builder .env para corresponder.

DEMO_UI_SECRET — Opcional, mas recomendado para qualquer implantação que não seja localhost. Qualquer pessoa com o URL do painel pode listar pedidos e executar aceitar e recusar se estiver vazio. Para um ambiente de preparo real, defina um segredo compartilhado.

COMMERCE_BASE_URL — Nunca inclua uma barra à direita. O cliente Commerce REST anexa /rest/V1/ automaticamente.

AIO_CLI_ENV — Definido como stage para o espaço de trabalho Stage. Altere para prod ao implantar para Production.

recommendation-more-help
commerce-learn-help-home