web payments quickstart

Início rápido de pagamentos pela Web

Guia de início rápido para usar o SDK de pagamentos na Web da Square

• Visão geral do SDK de pagamentos da Web.
• Documentação da API.

Começando

Comece clonando este repositório.

git clone https://github.com/square/web-payments-quickstart
cd web-payments-quickstart

Instale o Node.js que incluirá npm . Este repositório contém um arquivo .nvmrc se você usar nvm para gerenciar as versões do seu nó.

Então, para instalar as dependências, execute:

npm install

Execute o servidor de desenvolvimento.

npm run dev

Finalmente, abra http://localhost:3000.

Credenciais

Antes de receber um pagamento, você precisará configurar suas credenciais de desenvolvedor, que podem ser encontradas no Painel do Desenvolvedor.

Copie .env.example para .env.sandbox

cp .env.example .env.sandbox

Defina SQUARE_ACCESS_TOKEN com seu token de acesso Sandbox no painel do desenvolvedor.

 SQUARE_ACCESS_TOKEN =eX@mpl3_t0k3n

Reinicie seu servidor para usar este novo valor.

Lembre-se: não adicione seus tokens de acesso ao git!

Desenvolvimento

Configurar

Ao contribuir para este projeto, você desejará usar a versão do Node conforme definido por .nvmrc . Você pode usar o nvm para instalar a versão correta:

nvm install $( cat .nvmrc )

Siga as instruções de "Introdução" acima para instalar dependências e verificar se o servidor local inicia corretamente.

Teste

Você pode executar todos os linters, testes e compilações como CI com npm test .

Linting

Você pode executar todos os linters com npm run lint .

ESLint

ESLint analisa o código para encontrar e corrigir problemas. Usamos eslint-plugin-square para configuração pronta para uso.

npm run lint:eslint

Corrigindo avisos e erros automaticamente

Às vezes, o ESLint pode corrigir avisos e erros automaticamente para você com sua opção --fix.

npm run lint:eslint --fix

Mais bonito

Prettier é um formatador de código opinativo. Usamos @square/prettier-config para essas opiniões.

npm run lint:prettier

Corrigindo problemas de estilo de código

Se depois de executar npm run lint:prettier você receber um aviso como "Problemas de estilo de código encontrados nos arquivos acima. Esqueceu de executar o Prettier?", você pode fazer com que o Prettier os corrija.

npm run lint:prettier:fix

Integração Contínua

GitHub Actions é usado para nossos fluxos de trabalho de CI/CD. Consulte .github/workflows para obter detalhes.

Licença

Direitos autorais 2021 Square, Inc.

Licenciado sob a Licença Apache, Versão 2.0 (a "Licença"); você não pode usar este arquivo exceto em conformidade com a Licença. Você pode obter uma cópia da Licença em

http://www.apache.org/licenses/LICENSE-2.0

A menos que exigido pela lei aplicável ou acordado por escrito, o software distribuído sob a Licença é distribuído "COMO ESTÁ", SEM GARANTIAS OU CONDIÇÕES DE QUALQUER TIPO, expressas ou implícitas. Consulte a Licença para saber o idioma específico que rege as permissões e limitações da Licença.