DocumentaçãoCommerce“Guia do Payment Services”

Instalar Payment Services

Last update: Fri Nov 01 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Administrador

Para começar a usar os Serviços de Pagamento para Adobe Commerce e Magento Open Source, você deve concluir algumas etapas de integração.

INFO
Consulte o vídeo Configurar Payment Services para Adobe Commerce para obter mais informações.

Baixar e instalar a extensão Payment Services para Adobe Commerce e Magento Open Source é uma etapa de pré-requisito para usar o Payment Services.

Baixar a extensão

Você deve primeiro baixar a extensão do Commerce Marketplace antes de instalá-la.

  1. Navegue até a extensão de Serviços de Pagamento no Commerce Marketplace.
  2. Para escolher a edição e a versão, alterne Edition e Your store version para suas seleções preferidas.
  3. Clique em Add to Cart.
  4. Conclua o check-out e clique em Place Order.
  5. Verifique o email associado ao download do Marketplace para obter a confirmação e os detalhes do pedido.
NOTE
Para as versões 2.4.7 ou mais recentes do Adobe Commerce, o Payment Services está disponível e pronto para uso.

Instalar a extensão

Você pode instalar a extensão Payment Services para Adobe Commerce na infraestrutura em nuvem e em instâncias locais, que estão vinculadas à sua conta da Commerce mageid fornecida no processo de inscrição.
Magento Open Source clientes usam as instruções no local.

O Composer usa essas chaves durante a instalação inicial do Adobe Commerce ou em situações nas quais as chaves do Composer não foram salvas anteriormente no arquivo auth.json.

Consulte Obter suas chaves de autenticação para obter mais informações sobre como obter chaves do Composer.

Consulte Instalar uma extensão para obter mais informações sobre o que considerar antes de baixar e instalar uma extensão.

Adobe Commerce na infraestrutura em nuvem

Este método é usado para instalar a extensão Payment Services para uma instância de Commerce Cloud.

  1. Atualize seu arquivo composer.json:

    code language-bash 
    composer require magento/payment-services --no-update

  2. Atualize as dependências e instale a extensão:

    code language-bash 
    composer update magento/payment-services --with-dependencies

    Use o comando composer update para atualizar todas as dependências raiz.

  3. Confirme e envie suas alterações.

No local e outras configurações

Este método é usado para instalar a extensão Payment Services para uma instância local e clientes Magento Open Source.

  1. Para obter a extensão, execute estes comandos:

    code language-bash 
    composer require magento/payment-services --no-update

  2. Atualize as dependências e instale a extensão:

    code language-bash 
    composer update magento/payment-services --with-dependencies

    Use o comando composer update para atualizar todas as dependências raiz.

  3. Atualize sua instância:

    code language-bash 
    bin/magento setup:upgrade

  4. Limpe o cache:

    code language-bash 
    bin/magento cache:clean

  5. Confirmar alterações.

  6. Para garantir que o código comprometido seja implantado, atualize a instância.

NOTE
Payment Services 1.6.1 é compatível com o PHP versões 7.x. No entanto, é altamente recomendável atualizar para a versão mais recente do Payment Services.

Atualizar a extensão

Quando uma nova versão do Payment Services for lançada, você poderá atualizar facilmente sua extensão.

  1. Para obter a versão mais recente do pacote:

    code language-bash 
    composer update magento/payment-services --with-dependencies

    Use o comando composer update para atualizar todas as dependências raiz.

  2. Após a atualização do compositor, executar:

    code language-bash 
    bin/magento setup:upgrade

  3. Confirme e envie suas alterações.

Solução de problemas

Você pode ver erros ao tentar instalar a extensão Payment Services. Use os seguintes métodos de solução de problemas para resolver os erros.

Lista de repositórios

Verifique se repo.magento.com está presente na lista de repositórios.

Chaves do compositor incorretas

Se você vir o seguinte erro que indica que você tem as chaves do Composer incorretas:

Could not find a matching version of package magento/payment-services. Check the package spelling, your version constraint and that the package is available in a stability which matches your minimum-stability (stable).

Verifique se as chaves do Composer são válidas e se você tem acesso a outros pacotes de Magento.

Para ver quais chaves do Composer estão configuradas:

  1. Localizar o arquivo auth.json:

    code language-bash 
    composer config --global home

  2. Exibir o arquivo auth.json:

    code language-bash 
    cat /path/to/auth.json

  3. Consulte quais chaves estão associadas à sua conta do Commerce MageID.

Memória insuficiente para o PHP

Se você vir o seguinte erro indicando que você não tem memória suficiente para o PHP:

Fatal error: Allowed memory size of 2146435072 bytes exhausted (tried to allocate 4096 bytes) in phar:///usr/local/bin/composer/src/Composer/DependencyResolver/RuleWatchGraph.php on line 52

Aumente o limite de memória para o PHP em seu ambiente no php.ini.

Como alternativa, você pode especificar o limite de memória usando este comando: php -d memory_limit=-1 [path to composer]/composer require magento/payment-services.

Por exemplo:

php -d memory_limit=-1 vendor/bin/composer require magento/payment-services
recommendation-more-help
87189544-c8b9-4aef-af07-ed3578763c38